Table of contents
The Table of Contents block auto-generates a linked list of a document's headings. Insert it once near the top of long documents and it stays current as the doc evolves.
Using it
Slash menu → Table of Contents.
It scans the document's headings (H1–H6) and renders a nested, clickable outline.
Entries update live as you add, edit, or reorder headings — no manual maintenance.
Clicking an entry scrolls to that heading.
Where it helps
Long guides — setup docs, runbooks, and policy documents.
Public articles — ToC blocks render on the help center with anchor links, which also helps SEO (jump links in search results).
Specs — PRDs and design docs where reviewers jump between requirements.
ToC block vs outline minimap
ToC block | Outline minimap | |
|---|---|---|
Renders in | The document body (exported + public) | The editor's edge (editor-only) |
Maintained by | Automatic | Automatic |
Best for | Readers | Writers navigating while editing |
Both derive from the same heading structure, so they always agree.
Styling
The block inherits the document's typography, nests by heading level, and renders as a simple nested list in Markdown export.
Was this article helpful?