1
Paste the Markdown document
Start with the draft that already has a heading structure.
Free • Fast • No Registration Required
Generate a Markdown TOC from your document headings.
Paste the Markdown, choose the heading depth, and insert a linked table of contents that matches the current document structure.
Optimizer
Generate a linked table of contents from headings.
Output shape
The tool inserts a marker-based TOC block at the top so repeated runs can replace the existing TOC instead of stacking duplicates.
Why Use This Tool?
Markdown documents often start small and grow into something much larger: guides, RFCs, release notes, onboarding docs, or knowledge-base pages. At that point, a heading-based TOC becomes more than a nice extra.
This page turns the document structure you already wrote into a linked table of contents, which is much faster than maintaining the anchor links by hand.
How to Use This Converter in 3 Steps
2
Choose the TOC depth
Decide how many heading levels should be included in the generated table of contents.
3
Insert the generated block
Copy or download the Markdown with the TOC block added at the top of the document.
Common Use Cases
Long-form documentation
Add fast navigation to setup guides, specs, and internal docs.
Release notes and changelogs
Help readers jump between versions, sections, or grouped updates more easily.
Knowledge-base pages
Insert heading links into notes that have grown too long to scan linearly.
Frequently Asked Questions
How does the TOC get inserted into the Markdown?+
The page adds a marker-based TOC block near the top of the document, so running the generator again can replace the previous TOC cleanly instead of duplicating it.
What heading levels does it support?+
It reads Markdown headings from H1 through H6 and lets you choose how deep the generated TOC should go.
Will it work with GitHub-style heading anchors?+
Yes. The generator builds Markdown links using a slug pattern that is intended to match common GitHub-style heading anchors for normal Markdown documents.
Related Tools
MD Formatter
Normalize the document structure first so the heading hierarchy is cleaner before generating the TOC.
Table Builder
Use the table builder when the hard part is tabular syntax rather than heading structure.
Editor
Continue refining the document once the TOC has been inserted.
Markdown to PDF
Export the organized document after the TOC is in place.