markdown-toc
Updated 2026-09-13 · DocsAll Guides
Quick answer: Generate a linked table of contents from any Markdown document's headings. Open markdown-toc — everything runs locally in your browser, and files never leave your device.
Steps
- Paste the Markdown into the TOC generator.
- Choose heading depth (## and ### usually).
- Paste the generated list at the top of your document.
Important notes
- Anchor slugs differ across platforms — GitHub lowercases and hyphenates; Chinese headings follow platform-specific rules, so click-test after publishing.
- Regenerate the TOC after heading edits; do it last, before publishing.
Common questions
Auto-maintaining? Static-site plugins can; this tool targets one-shot generation and GitHub READMEs.
Depth too deep? Two or three levels stay readable.
When to use this
For documentation sites, a sticky TOC generated at build time is usually better; use this tool for READMEs and one-off documents.