Guides JP

Markdown TOC Generator

Paste your Markdown and instantly generate a linked table of contents. Supports GitHub-style anchors, nested indentation, and level ranges.

Last updated: 2026/10/16 Developer Feedback & bug reports
Markdown Input
Table of Contents
Headings: 0 
Your table of contents will appear here.

How to Use

1

Paste Markdown

Paste Markdown containing headings (# to ######) into the input field. "#" inside code blocks is automatically ignored.

2

Adjust Options

Choose the heading level range, bullet or ordered list, and whether to include anchor links.

3

Copy the TOC

Copy the generated table of contents with one click and paste it at the top of your README or document.

About the Markdown TOC Generator

A web tool that parses Markdown headings and automatically builds a table of contents (TOC). It generates GitHub/GitLab-style anchors (slugs), so the TOC works as in-page links the moment you paste it into your README.md. All processing happens in your browser and your text is never sent to any server.

Features

  • GitHub-style AnchorsGenerates GitHub/GitLab-compatible slugs, handling non-ASCII headings and duplicates (-1, -2).
  • Level Range & NestingPick which heading levels (H1-H6) to include and let the TOC indent automatically by depth.
  • Code Block AwareIgnores "#" inside fenced code blocks (``` or ~~~) so comments are never mistaken for headings.
  • Privacy FirstAll processing happens in your browser. Your text is never sent to any server.

Use Cases

  • Add a table of contents to a GitHub / GitLab README.md
  • Build a TOC for technical blogs and documentation
  • Check the structure of Markdown articles
  • Extract an outline (heading list) from long Markdown
  • Generate navigation for wikis and internal docs

FAQ

Do the anchor links work on GitHub?
Yes. The tool uses a GitHub/GitLab-compatible slug algorithm, so pasting the TOC into your README.md gives you working in-page links. Note that anchor rules can vary slightly between platforms.
Are non-ASCII (e.g. Japanese) headings supported?
Yes. Headings with non-ASCII characters are turned into anchors too. Spaces become hyphens and punctuation is removed.
What happens with duplicate heading names?
Just like GitHub, the second and later occurrences get a numeric suffix (-1, -2, ...) appended to their anchor to keep them unique.
Are "#" characters inside code blocks treated as headings?
No. Lines inside fenced code blocks (``` or ~~~) are excluded from parsing, so a "#" comment is never mistaken for a heading.
Is my text sent to a server?
No. Everything runs in your browser via JavaScript. Your input is never sent to or stored on any server.
Can I change which heading levels are included?
Yes. You can set a minimum and a maximum level. For example, you can exclude the H1 title and include only H2-H4 in the TOC.

Related Tools

JSON Formatter Format and validate JSON with syntax highlighting Password Generator Generate secure random passwords with one click UUID Generator Generate UUID v4 in bulk with format options ASCII Converter Convert between text and ASCII/Unicode codes Base64 Encoder Encode and decode text or files to Base64

Popular Tools

Character Counter Count characters, words, and lines in real-time QR Code Generator Create custom QR codes with logo, colors & styles IP Address Checker Check your global IP address Percent Calculator Calculate percentages easily Image Converter Convert between PNG, JPG, and WebP formats Image Compressor Compress PNG, JPEG, WebP images to reduce file size

Related Guides

Markdown for Beginners: How to Write Headings, Lists, Links, and Tables A beginner guide to writing Markdown. Learn the core syntax for headings, lists, links, emphasis, code, and tables, plus how to export to HTML and PDF and use Markdown on GitHub and blogs. How to Write Markdown Tables: Pipes, Hyphens, Alignment, and Line Breaks Learn how to write Markdown tables from the basics: building header and separator rows with pipes (|) and hyphens (-), left/center/right alignment set by the colon (:) position, line breaks and pipe escaping inside cells, and how tables render on GitHub and in Notion, with examples.