thlorenz/doctoc

Health v2 · maintenance only

Adoption not part of the score

4468 stars · 483 forks observed · 2026-10-01

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

DocToc is a Node.js command-line tool that generates and maintains table of contents sections in Markdown files within a local git repository. The generated links are compatible with anchor formats used by GitHub, GitLab, Bitbucket, and other sites.

Use cases

• add a table of contents to my README
• generate TOC for all markdown files in a repo
• check that docs table of contents is up to date in CI
• update existing doctoc TOCs automatically
• use a git hook to keep markdown TOCs current
• generate GitHub-compatible anchor links for headings

When to choose

• you maintain markdown documentation in a git repository and want navigable TOCs
• you need TOC links that work on GitHub/GitLab/Bitbucket
• you want to enforce up-to-date TOCs in CI via dry-run exit codes

When to avoid

• you need TOCs for non-markdown formats like reStructuredText or AsciiDoc
• you want a GUI or in-editor TOC tool rather than a CLI
• you need fully custom TOC rendering beyond the provided renderers

Facets

cli-tool · maturity active

markdown documentation parser cli documentation developer-tools cli cross-platform table-of-contents markdown-toc github-anchors git-hook npm-package command-line nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="thlorenz/doctoc")