Use case or problem
When working on large markdown notes in Obsidian, users often need a quick way to navigate between different sections. While the /
operator offers various functionalities, it currently lacks a “Table of Contents” and a “Table of Figures” feature feature, which could significantly improve navigation efficiency within documents.
Proposed solution
Enhance the /
operator to include an option for inserting or displaying both a dynamic Table of Contents and a Table of Figures. These tables would automatically extract and list all headers and figures within a note, allowing users to quickly jump to different sections or visual elements. Implementation could involve:
- Typing
/toc
to generate a live-updating Table of Contents. - Typing
/tof
to generate a Table of Figures, listing all embedded images, diagrams, and media. - Clicking on an entry in either table to immediately navigate to that section or figure.
- Customization options to format or limit the depth of headers displayed. This is expanded down below for an easy understanding.
- Format customization: Users could adjust the appearance of the Table of Contents to fit their needs. Options might include choosing between numbered lists, bullet points, collapsible sections, or different text formatting styles for improved readability.
- Depth limitation: If a document has multiple levels of headings (e.g., H1, H2, H3, etc.), users might prefer to show only higher-level headings (like just H1 and H2) rather than including all subheadings. This would keep the TOC concise and focused, reducing clutter. Similarly, for the Table of Figures, users might want to filter by figure type (e.g., only images, only diagrams).
- Auto-numbering: Figures in the Table of Figures could be automatically numbered for easy referencing within the document.
Current workaround (optional)
Currently, users manually create Tables of Contents and Tables of Figures by inserting markdown links to headings and images, or rely on community plugins. However, this process is tedious and lacks the intuitive, automated functionality that would make navigation seamless.
Thank you for your time and consideration