Markdown TOC Generator - Online Table of Contents Creator

GitHub-style and GitLab-style anchors, plus a custom anchor template that combines text and slug via placeholders. All six levels H1 to H6 are recognized, with min/max heading levels controlling TOC depth, plus ordered or unordered lists and numbering styles. The result can be copied on its own or inserted at the top of the document — leave a blank line after insertion so it doesn't stick to the first paragraph.

By design: pseudo-headings inside fenced code blocks are filtered so sample code never gets mistaken for the article outline.

It can. The two platforms differ in casing, punctuation stripping, and HTML handling, and some static site generators even keep Chinese characters where GitHub would not. When publishing across platforms, spot-check whether the first two TOC links jump correctly; if not, switch the anchor style or align with a custom template.

Three cases: for short pieces (roughly under a screen and a half) a TOC is noise; badly skipped heading levels should be fixed first, or the indentation misleads readers; headings containing inline code or complex links parse unreliably, so hand-write those. Also keep a top-level Contents heading out of the generated range to avoid self-reference noise.

Anchors follow headings — renaming a heading renames its anchor, which bites hardest for sections cited by external links. Before a major rename, search for old anchor references and set up redirects or keep the old title as an alias.