Smart TOC
A floating, draggable table of contents panel for VS Code's built-in Markdown preview.
Features
- Floating panel — overlays the preview, doesn't take up editor space
- Draggable & resizable — position it wherever you like
- Live scroll tracking — current heading is highlighted as you read
- Click to jump — click any heading to scroll the preview there
- Collapse when not needed — minimize to a small pill button with one click
- Persisted position — panel placement is remembered across sessions
- Themes — follows VS Code's light/dark theme automatically
Usage
Open any Markdown file and switch to the Preview (Ctrl+Shift+V / Cmd+Shift+V). The TOC panel appears automatically in the top-right corner.
| Action |
How |
| Jump to heading |
Click the heading in the TOC |
| Move panel |
Drag the panel header |
| Resize panel |
Drag the panel edge |
| Collapse |
Click the × button — a small "TOC" pill stays on the right edge |
| Expand |
Click the pill button |
| Copy headings |
Open the ⋮ toolbar menu → Copy as... |
Known Limitations
- Works only with VS Code's built-in Markdown preview — not with Markdown Preview Enhanced or other custom previews
- Headings start from
h2 (the first # heading is typically the document title)
Changelog
0.1.0
Initial release.
- Floating, draggable TOC panel in the built-in Markdown preview
- Live scroll tracking with active heading highlight
- Click-to-jump navigation
- Collapsible to a pill button
- Persisted panel position and visibility
- Light/dark theme support
- Copy headings as plain text, Markdown, HTML, or JSON
License
MIT
| |
