Support table of content [toc]

Ideally it should be possible to:

  1. See the TOC in a sidepane so when you scroll down a long note you never lose sight of the TOC;
  2. Offer option to number the headings and subheadings.

Here is an example from Typora, with the ToC in the sidepane. That’s what I mean with my comment.



It would also be useful if Obsidian would do folding in Preview mode, the way that Marked 2 does. That would be a useful alternative to a TOC. (When I read that Obsidian had folding, that was what I was expecting to find.)

If it can do it in Edit mode, would it be a lot harder to implement in Preview mode?


It could be very useful, and I think an implementation similar to Typora with [TOC] showing a list of links to headers.


Sounds to me what you really want is for obsidian to remember your place in a note, so that when you switch back to the note, you see the cursor in the same place and exact same content as before you switched. Also see Place cursor in editor when navigating back/forwards

A plugin that may be worth writing is to have a pop-up TOC when you right click!


VSCode has a left side navigation pane where all the levels are listed, might be better than a TOC you need to scroll to all the time to see the contents. This might even be a plugin if those allow creating panes.

Having a [toc] at the top of a long note is useful when it’s exported as a PDF.

There’s a separate request for what you suggest.


Yes. But if you use Pandoc with (hopefully internal links updated for real Markdown format) Obsidian notes in future you could get TOC via special macro for PDF.

I also really would love this. Also an optional document outline. I upvoted the mentioned thread for that feature too.


+1. This is very much needed for a longer-form notes, for example when writing a book or report.

Currently it’s very difficult to navigate in a long document.


I actually liked the way it is implimented in Typora. you can just type [TOC] anywhere and it generates a TOC for you.

But from usability wise, I prefer the way its done in Zettlr, where you get a small button with all the headings listed. Just tap on the heading and you can jump to the section. Its quite handy


I think both options make sense - having the TOC inline with a [toc] directive, as well as being able to show it in a separate pane. Similar to how code IDEs show the structure of code (its classes and methods) as outline.

1 Like

I thought it’d be nice to see the toc in different formats according to what the user chooses in the plugin menu.
My personal absolute favorite way to view the toc would be Google Docs style, where there’s a subtle overlay on the left side to navigate to any header/subheader of the doc file.


As others have already mentioned, for the time being we can use the TOC features of Typora which integrates nicely with Obsidian when setting it as the default app for opening MD documents and adding a keyboard shortcut for that (possible since the latest insider version). Typora also provides a nice sidebar-TOC similar to Google Docs.


I’m aggregating a lot of resources from different places, cited under a lot of headers and subheaders. (Yes, I use all 6 sizes!) It would be fantastic to be able to hit a button and auto generate a TOC list of links to all headers, which I could then modify/re-arrange as I wanted. As an alternative, perhaps an outline sidepane (like you can get in gdocs) that lists all the headers in order.


It’s been requested already - Support table of content [toc].


If you are using ios 1writer or iawriter you can automatically generate TOC by typing {{TOC}} at the top of your obsidian document, although it won’t display the table of contents in obsidian it will in these apps.

Just to chime in, as a new user who’s transitioning over from Qownnotes, this would be a wonderful addition – a ToC pane for quick navigation is the only major thing I’m missing so far. Inline ToC would be nice too, though a bit less of a priority for me (since I’d be mainly using Obsidian for reading my notes in Markdown, and would just add a ToC with Pandoc when exporting to PDF).

1 Like

I rely on and appreciate this feature so significantly in my other apps! And I’m so eager to phase those apps out for Obsidian!

Oh My Gosh! Why can’t we have this yet? Taking soooo looong! :sob:
Kidding! :rofl: I can be patient :timer_clock:
Just don’t want to be for TOC


Like you, I am eagerly awaiting this plug-in because I also want to move my other markdown stuff into Obs.


I am used to work with longer markdown files. For that reason it is always good to have an overview of the documents’ structure.
A table of content is a neat feature to have for quickly navigate through a *.md file.

I made the following mockup as my proposal how this could look like in the UI.

It is the beloved collapsible “Outline” view I am used to have in VS Code and/or Typora.
And I would also :heart: to have this feature in Obsidian!

This view could be placed in the left/right sidemenu (I would prefer have it on the right).
So you could also hide it when you don’t need it.

In addition, the Outline view should also be usable in the “Slide” mode.
I did my first presentation for some colleagues in Obsidian a few days ago and they were very impressed. But I would be awesome to have a “TOC per slide” there.

:heart: you guys! Keep up the great work!