Linked outline from your headings, GitHub-slug compatible.
- [Install](#install) - [Usage](#usage) - [Command-line flags](#command-line-flags) - [FAQ](#faq)
📑 Slugs follow GitHub’s algorithm: lowercase, spaces to dashes, punctuation stripped, and duplicate headings get -1/-2 suffixes — so anchor links actually land on the right heading.
GitHub lowercases headings, strips punctuation, converts spaces to dashes, and appends -1/-2 for duplicates. Links generated elsewhere frequently miss the duplicate rule — these do not.
Depth H2-H3 produces a scannable outline for typical articles; pulling in H4+ helps long technical docs but clutters README files. The selector above regenerates instantly.
Drop the list right after your intro paragraph. On GitHub, readers can jump via the built-in outline icon too — but rendered TOCs work everywhere Markdown renders, including blogs and docs sites.
The Markdown TOC Generator creates markdown toc generator on demand, right in your browser. Set the options you need, click generate, and the result is ready to copy. Because everything runs locally, nothing you enter or produce leaves your device.
Generators like this are useful when you need a specific output (a password, a UUID, a QR code, placeholder text) and don't want to install an app or trust an unknown website with your data. This tool is free, has no usage limits, and works the same on phone and desktop.
Common uses: people reach for this tool when they need to use a generate table of contents readme, markdown heading anchor generator, github markdown internal links, or nested toc from markdown headings.
Browser-based tools like this one have a few real advantages over installed software or manual methods:
More tools you might find useful