Text

Markdown TOC Generator

Generate a clean, linked table of contents from any Markdown document. Pick the heading levels you want included, choose ordered or bullet lists, and copy a ready-to-paste TOC for your README, docs, or blog post.

Tool Summary Answer Block

This tool accepts structured input and returns deterministic output in the browser with no server upload.

Tool name: Markdown TOC Generator
Input intent: Provide source content to transform, validate, or analyze.
Output intent: Receive normalized output suitable for copy, reuse, or debugging.
Example input: # Guide ## Install ## Configure ### Environment ### Secrets
Example output: - [Install](#install) - [Configure](#configure) - [Environment](#environment) - [Secrets](#secrets)

Markdown sourceDrop file

Recent inputs0

Your last 5 inputs will appear here.

Minimum heading levelMaximum heading levelIndent sizeOrdered list (1.)Include anchor links

9 headings detected

- [Installation](#installation)
  - [macOS](#macos)
  - [Linux](#linux)
- [Configuration](#configuration)
- [Usage](#usage)
  - [Basic example](#basic-example)
  - [Advanced example](#advanced-example)
- [Troubleshooting](#troubleshooting)

Tool Introduction

Tool Overview

Long Markdown files get easier to navigate when they start with a TOC. This tool parses your document, skips code fences, deduplicates anchor slugs the same way GitHub does, and builds a nested list that mirrors your heading hierarchy. Everything runs in the browser — your draft never leaves your tab.

Use Cases

Add navigation to a long README on GitHub
Build a docs landing page with deep-linked sections
Insert a sticky TOC into a Markdown blog post
Audit heading structure for a documentation site

Input/Output Examples

H2-H3 range, bullet style, anchor links enabled.

Input Intent

# Guide
## Install
## Configure
### Environment
### Secrets

Output Intent

- [Install](#install)
- [Configure](#configure)
  - [Environment](#environment)
  - [Secrets](#secrets)

FAQ

Are anchor slugs compatible with GitHub?+

Yes. The slug algorithm lowercases text, replaces spaces with dashes, strips Markdown emphasis characters, and de-duplicates repeated headings — matching GitHub's behavior.

Does it ignore code blocks?+

Yes. Fenced code blocks are skipped so `# comments` inside code don't become TOC entries.

Can I generate an ordered (numbered) list?+

Yes. Toggle the ordered option to emit 1. style markers instead of bullets.

Is my Markdown sent anywhere?+

No. Parsing happens entirely in your browser.