Markdown TOC Generator

Markdown TOC Generator

Extract headings and generate clickable, indented Table of Contents with customizable depths and list styles.

Table of Contents Generator

Auto-generate GitHub & CommonMark compatible TOC with anchor links and hierarchy indentation

Levels:to
MARKDOWN SOURCE INPUT (11 Headings Found)
GENERATED TOC MARKDOWNH2 through H4
- [Introduction](#introduction)
  - [Background & Motivation](#background-motivation)
  - [Scope & Goals](#scope-goals)
- [System Design](#system-design)
  - [Editor Subsystem](#editor-subsystem)
  - [Health Analysis Engine](#health-analysis-engine)
  - [Privacy Radar](#privacy-radar)
- [Deployment & Production](#deployment-production)
  - [Server Requirements](#server-requirements)
  - [Caching Strategy](#caching-strategy)
10 TOC items

Why Every Long Document Needs a Table of Contents

Technical guides, API specifications, and comprehensive open-source README files can easily span hundreds of lines. Adding an interactive Table of Contents improves reader navigation, boosts SEO outline scannability, and establishes professional repository documentation.

GitHub Markdown Slug Generation Rules

  • Lowercase conversion: All characters are converted to lowercase (# Getting Started → #getting-started).
  • Whitespace to hyphens: Spaces and multiple whitespace characters are collapsed into single hyphens.
  • Punctuation stripping: Colons, question marks, commas, backticks, and periods are stripped out.

Frequently Asked Questions

How does Markdown Table of Contents (TOC) linking work?

Markdown TOC entries use anchor links: [Heading Title](#heading-title). Heading text is converted into lower-case kebab slugs, removing punctuation and replacing spaces with hyphens according to GitHub markdown anchor conventions.

Can I control the heading depth in the TOC?

Yes! Use the "Max Depth" slider in the generator toolbar to select H2, H3, or H4 maximum nesting levels.

Can I switch between bulleted and numbered TOC lists?

Yes! Toggle the List Style switch between "Bulleted (-)" and "Numbered (1.)" formats.

Does this TOC generator work with existing GitHub READMEs?

Yes, simply paste your entire README file into the left pane and copy the generated TOC directly into the top of your markdown document.

Related Markdown Utilities

Experience Full MDForge Studio

Unlock multi-document tabs, Health audits, Privacy scanning, and Time Machine snapshots in one distraction-free window.

Open Fullscreen Studio