How does the Markdown TOC generator work?

Paste any Markdown document into the input area. The tool scans all lines starting with one or more # characters (H1-H6), extracts the heading text, generates slug-based anchor IDs (GitHub/GitLab style) and produces a nested or flat Table of Contents you can copy.

Does it match GitHub's anchor ID format?

Yes. By default, the tool uses the same slugify rules as GitHub: lowercase, spaces to hyphens, drop punctuation except hyphens, and append -1, -2 etc. for duplicate headings to keep IDs unique.

Can I choose a different heading level depth?

Yes. Use the min/max heading level options to include only specific heading levels (e.g. only H2 and H3). The tool will ignore anything outside the range.

What is the difference between nested and flat TOC styles?

Nested (default) produces a hierarchical Markdown list that mirrors heading depth with indentation. Flat renders all entries at the same level — useful when you want a simple ordered list with no visual hierarchy.

Markdown Table of Contents Generator - Auto TOC Builder

Style

Min level

Max level

Min heading

Markdown input

Generated TOC

Live HTML preview