Start a project

Tool 253 of 425 · Markdown

Markdown Table of Contents Generator

Builds a linked table of contents from your Markdown headings that works on GitHub.

Markdown Table of Contents Generator

Your input

Result

Markdown
HTML

    01

    What it does

    Builds a linked table of contents from your Markdown headings that works on GitHub.

    • GitHub-style anchor slugs
    • Pick heading levels
    • Bullets or numbers
    • Skips headings inside code blocks

    02

    Private by design

    Everything happens in your browser. Nothing you type, paste or upload is sent anywhere, and it keeps working offline once the page has loaded.

    03

    What you get

    TOC Markdown and HTML, with a Copy and a Download button on every result.

    • Table of contents
    • Markdown
    • GitHub anchors

    Why it matters

    Long READMEs and docs need a contents list, and GitHub's anchor rules (lower case, hyphens, -1 for duplicates) are fiddly.

    Paste the document and copy the list to the top.

    How to use it

    1. Type or paste your input; the example shows the format.
    2. Press Generate contents. Results also update as you type.
    3. Read the summary line, then the table, notes or output below it.
    4. Copy or download what you need. Nothing leaves this page.

    FAQ

    Why do my links not jump?

    Anchors must match exactly; emoji and punctuation are dropped by GitHub, which this copies.

    Does it include the title?

    Set the minimum level to 2 to skip the H1.

    Is my input uploaded?

    No. The tool runs in your browser and nothing you type, paste or open is sent anywhere.

    Can I rely on the result?

    It follows the public specification or formula named on this page and says where it simplifies. Check anything critical against the official tool or documentation before you ship it.

    Work with me

    Want a site that gets these right?

    I build fast, accessible websites and web apps that pass these checks from day one. Tell me about your project and I'll reply personally with honest next steps.

    All developer tools · Back to leej.uk