Render text in Outline pane instead of showing the raw markdown (reading mode rendering)

Does anyone have a solution?

Use case or problem

Ease of reading the outline pane when headings include links or other markdown formatting.

How outline pane looks now

Proposed solution

Convert markdown to normal text in outline pane.

Current workaround (optional)

Not using markdown.

Related feature requests (optional)

I’m not sure if this adds to the weight of attention, but this is my most desired feature. +1

@patch : for more weight add your upvote to the OP at the top of this page.

1 Like

Without this feature, I have to link things below the heading and introduce a bit of mess. +1

I also would really like this feature to be implemented. Currently, there is just too much clutter and the outline with the types of names, links and styles I use is almost unusable.

I agree with this request but would like the outline to still render comments. I use comment-only headings to mark scenes in fiction so I can see the overview in the outline (and so I can fold the sections).

Example: ## <!--5. Franz tells how his injury happened.-->

I like having the markup for them in the outline so I know they’re comments, but it’s not crucial — the text is what matters.

Steps to reproduce

  1. Create a header/subheader with a character that needs to be escaped (example: ## Something \*).
  2. Look at the outline.

Expected result

The name of the header/subheader in the outline should be Example *.

Actual result

The name of the header/subheader in the outline is Example \*.


  • Operating system: elementary OS 5.1.7 Hera
  • Obsidian version: v0.9.20

Additional information


1 Like

Would be awesome

+1 Agree

+1 :+1: :+1: :+1:

1 Like

@shuojie Please make sure you upvoted the original post at the top of this page.


I wrote a plugin to fix this, maybe use it as a workaround before official implementation:


Excellent plugin! Love it! Thank you @the_tree !

This is a nice interim solution, thank you! Request: can you add an option that just strips out everything formatting-related, and outputs just the text? It’s weird to have it support links when the outline item is already a link (= conflict), and using bold/emphasis in titles is really just meant for the output, not for the outline, which is just a table of contents for that page.

I added my vote to the OP because this is a much-desired feature (IMO: bug) change I want to see in Obsidian!

The title in outline view shows escape characters
(i.e. ) as well as formatting characters (e.g. asterisks)

Steps to reproduce

  1. Create a new note
  2. In the note, create a markdown title whose content includes a #.
  3. Paste the following on the second line: #### *Hello* C\#
  4. The title in the outline view does not match the text of the title

Expected result

The title contents in the outline should match the title on the page

Actual result



  • Operating system: Windows
  • Debug info:
    Obsidian version: v1.1.9
    Installer version: v1.0.3
    Operating system: Windows 10 Pro 10.0.22000
    Login status: not logged in
    Insider build toggle: off
    Live preview: on
    Legacy editor: off
    Base theme: dark
    Community theme: none
    Snippets enabled: 0
    Restricted mode: on


Additional information

Just to connect the dots, there is a feature request for this:

And a possible workaround:

Giving my +1 here as well. I used to only use actual bulleted-outlines, but have started adding headings in order to make use of the Outline panel/tool. It is annoying to see the markdown symbols in the list.

Edit: I now see the Quiet Outline recommendation - after a brief test, it seems to do what I want and more!

If using inner link as heading, then the square brackets are also shown in the outline. I think the square brackets should hidden in the outline.

Is that possible to remove the square brackets in outline when using inner link as heading?

Still very much interested in a native solution! The outline plugin mentioned by @eightning works well but I think it would be great if we wouldn’t need a plugin for that!

1 Like