Table of Contents
Click "Contents" to see every heading in your document and jump to any section.
The Table of Contents panel gives you a bird's-eye view of your document structure. Open it from the document header, click a heading, and the editor scrolls straight to that section. On wide screens (960px and up), the Table of Contents also lives in a sticky 220px rail on the left, always visible while you write.
How to Use
Open the Panel
Click the Contents button in the document header. A panel appears showing all headings in the current document.
Jump to a Section
Click any heading in the list. The editor scrolls directly to that section.
Close the Panel
Either click outside the panel or press Escape.
What You See
The panel shows all headings from H1 through H6 with visual hierarchy:
| Heading Level | Style |
|---|---|
| H1 | Bold |
| H2 | Muted |
| H3 and below | Italic, progressively indented |
This lets you see the structure of your document at a glance.
Change a Heading Level
As of v1.7.2, you can restructure your document straight from the Table of Contents. Right-click any row to open a context menu, choose Change heading level, and pick H1 through H6. Each option shows its keyboard shortcut hint.
The shortcuts also work globally anywhere in the editor:
| Platform | Shortcut |
|---|---|
| macOS | ⌥⌘1 – ⌥⌘6 |
| Windows / Linux | Ctrl+Alt+1 – Ctrl+Alt+6 |
Changing a heading level is a single undo step, and your scroll position stays put, so you do not lose your place when you promote or demote a section.
Auto-Updates
The panel updates automatically as you write. Add a heading, remove one, or change its text, and the contents panel reflects the change within about 300 milliseconds. No manual refresh needed.
Empty Documents
If your document has no headings, the panel shows a helpful message instead of a blank box. Add some headings and they'll appear in the panel immediately.
No Configuration Needed
There are no settings to toggle and no frontmatter properties to add. If your document has headings, the Contents button works.
Related
- Core Editor — Editor basics
- Keyboard Shortcuts — All shortcuts
- Text Formatting — Headings and formatting