Markdown TOC Generator

Auto-generate a Table of Contents from your Markdown headers (#/##). Free tool with support for internal anchor links.

How to Use
Sponsored Build AI Agents with No Code - Creao AI
Recommended Related Tools
MD Table Converter
Convert various formats such as Excel, CSV, JSON, and HTML into Markdown tables instantly.
MD to PDF
Convert your Markdown into beautifully designed PDF documents easily.
MD Table Maker
Just type in your data to instantly generate Markdown table code. A free tool you can use easily for GitHub and blogs.
MD Image Base64 Inserter
Drag and drop images into your Markdown to convert and embed them as Base64 data on the spot. No image file management or path setup needed.
MD to Text
Remove unwanted symbols from Markdown text and convert it to clean plain text.
Word to MD
Instantly convert Word documents to Markdown in your browser.

Instantly Extract TOCs from Long Markdown Docs

Automatically extract headers from your Markdown text to generate a Table of Contents (TOC) instantly. Create TOCs with internal anchor links effortlessly, which is highly useful for README.md files and technical blogs.

How to Use

Auto-generate a Markdown TOC in just 3 simple steps. You can also customize output settings intuitively.

STEP1

Input Text and Select Extraction Level

Paste your Markdown text into the left input area. Then, select the header levels (H1 to H4) you want to extract using the options at the top.

Input Markdown text and select target headers
STEP2

Customize Output Format

Toggle the "List Format" and "Internal Links" checkboxes to match your needs. Enabling internal links will generate an anchor-linked TOC that jumps to each section.

Generate TOC with list and anchor link settings
STEP3

Copy the Generated TOC

Once the table of contents appears in the right output area, simply copy it and paste it into your Markdown document.

Copy the output TOC for use
Key Features

One-Click Extraction

Just paste your text, and the tool accurately picks up only the headers from complex Markdown structures.

Flexible Hierarchy Levels

Freely select which header depths to include in the TOC, ranging from H1 down to H4.

In-Page Anchor Link Support

Automatically generates a TOC with internal links that function perfectly on platforms like GitHub.

Auto List Formatting

Automatically organizes and outputs proper indents and list markers (-) based on the header hierarchy.

Secure Local Processing

No data is sent to our servers. Safely process unpublished internal documents completely within your browser.

Ideal For

Open Source Developers

For those whose README.md files are getting long and want to add a TOC for better readability.

Tech Bloggers

For writers publishing long-form articles on Markdown-supported platforms like Dev.to or Hashnode.

Document Managers

For those tired of manually adjusting in-page link IDs for company Wikis or specifications.

All Markdown Users

A table of contents gives you an instant overview of even the most complex document structures.

Frequently Asked Questions
How are the internal anchor links generated?
Based on standard Markdown specs, we automatically generate anchor links by converting header text to lowercase and replacing spaces with hyphens (e.g., `[Header](#header)`). This works natively on GitHub and most platforms.
What happens if headers contain code blocks or special characters?
The tool tries to extract them as plain text as much as possible, though some complex markdown inside headers may not perfectly match the anchor ID depending on the platform.
Is this tool free to use?
Yes, no account registration is required, and you can use it for free as many times as you like.
Is it safe to input highly sensitive text?
Yes. All processing happens locally in your device's browser. Your text content is never saved or sent to any external server.
Related Tools
Markdown Table Generator
Convert various formats such as Excel, CSV, JSON, and HTML into Markdown tables instantly.
Convert Markdown to PDF
Convert your Markdown into beautifully designed PDF documents easily.
Markdown Table Maker
Just type in your data to instantly generate Markdown table code. A free tool you can use easily for GitHub and blogs.
Markdown Image Base64 Embed & Insert Tool
Drag and drop images into your Markdown to convert and embed them as Base64 data on the spot. No image file management or path setup needed.
Convert Markdown & AI Text to Plain Text
Remove unwanted symbols from Markdown text and convert it to clean plain text.
Convert Word (.docx) to Markdown
Instantly convert Word documents to Markdown in your browser.