ekalinin/github-markdown-toc

Health v2 · maintenance only

Adoption not part of the score

3296 stars · 2684 forks observed · 2026-08-28

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

gh-md-toc is a dependency-free shell script that generates a table of contents for GitHub README.md files and wiki pages. It can process stdin, local markdown files, or remote files hosted on github.com, and supports auto-inserting and updating TOC sections.

Use cases

• generate a table of contents for my GitHub README.md
• auto-insert and update TOC in markdown docs
• create TOC for a GitHub wiki page without installing software
• generate markdown TOC from stdin in a shell pipeline
• add table of contents to multiple markdown files at once
• generate TOC in GitHub Actions CI

When to choose

• you want a zero-dependency shell script for GitHub markdown TOC generation
• you work on Linux or macOS and want a quick CLI utility
• you want to automate TOC updates via GitHub Actions or CI

When to avoid

• you are on Windows and prefer a native binary (use the Go implementation instead)
• you need general-purpose markdown processing beyond TOC generation
• you need parallel processing or a more robust implementation

Facets

cli-tool · maturity stable

markdown developer-tools cli documentation developer-tools documentation cli table-of-contents github-readme shell-script markdown-toc command-line linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="ekalinin/github-markdown-toc")