📑

Markdown TOC Generator (Auto Table of Contents)

Generate a Table of Contents from markdown — GitHub-compatible anchor links. Strip diacritics, numbered list, checklist. Great for READMEs, docs, long blog posts.

All tools Browser-only

Markdown

TOC

Options

Min level Max level Style Indent (spaces)

Strip diacritics in anchor links Add section numbers (1.1, 1.2, 2.1…)

Generate a Table of Contents from markdown — for READMEs, docs, long blog posts. Anchor links match GitHub/GitLab/Hugo/Astro slug rules.

When you need a TOC

Project READMEs: long files → readers jump to the section they need.
Docs sites: Astro/Docusaurus auto-generate TOCs, but GitLab/GitHub markdown does not — add manually.
Long blog posts: 3000+ word articles — a TOC at the top helps navigation and dwell time (good for SEO).
Notion / Obsidian: paste a markdown export — get an instant outline.

Anchor link rules

GitHub/GitLab convert headings into slugs:

Everything lowercase.
Spaces → hyphens.
Strip special characters (? ! : ...).
Strip diacritics — Vietnamese accents stay in the slug if you don't strip!
Duplicate headings → add -1, -2… suffixes.

Tips

Strip Vietnamese diacritics: enable for clean ASCII slugs — works with GitHub and Hugo. E.g. "Cài đặt" → #cai-dat (NOT #cài-đặt).
Min/max level: H2-H3 is usually enough. H1 is the post title → exclude. H4-H6 is too granular.
Numbered + checklist: great for step-by-step tutorials (e.g. "Install", "Configure", "Run").
Code blocks: the tool skips headings inside fenced code blocks ``` — no false positives from # comment in code.

Who this is for

Fullstack/backend/devops engineers — debug JWT, format JSON/SQL, parse cURL, compute CIDR subnets, draft Mermaid diagrams, write conventional commits… Daily toolkit alongside your terminal and editor.

FAQ

Is my pasted code/token sent anywhere?

No. All TopDev dev tools run 100% client-side — JWT, SQL, JSON, cURL, regex… process in-browser. Disconnect to verify. Safe for internal tokens, production DB queries, API keys.

Does it work offline / install as a PWA?

Tools work offline after the first load. Installable PWA is on the roadmap — for now you can bookmark and use without internet.