md-toc-generator
Generates a table of contents for Markdown documents. Scans headings, builds nested lists with anchor links, and supports GitHub/VS Code styles. Handles edge cases like fenced code blocks and heading levels beyond H6. Optionally reads a custom include file from `references/` when present overrides default heading patterns.
- License 许可
- MIT
- 最近更新
- 2026-08-21
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- md-toc-generator
- license
- MIT
- version
- 1.2.0
- description
- Generates a table of contents for Markdown documents. Scans headings, builds nested lists with anchor links, and supports GitHub/VS Code styles. Handles edge cases like fenced code blocks and heading levels beyond H6. Optionally reads a custom include file from `references/` when present overrides default heading patterns.
02 资源文件 2
- 参考文档_provenance.json1.4 KB
- 脚本md_toc.py3.8 KB
03 SKILL.md 正文
Markdown TOC Generator
Utility to create a hierarchical table of contents from any Markdown file. It parses heading tags, respects indentation, and emits clean bullet lists with relative anchors. Works standalone or as a library.
Usage
python md_toc.py input.md [-o output.md] [--style github|vscode]
If a file named references/md_toc_config.json exists in the same
directory, it overrides default parse settings (e.g. custom heading
regex, ignored heading levels, or anchor prefix). The tool loads it
automatically to stay compatible with legacy project configurations.
Features
- Detects ATX and Setext headings.
- Skips headings inside fenced code blocks.
- Supports nested TOC up to six levels.
- Generates GitHub-compatible and VS Code-compatible anchors.
- Lightweight, no external runtime dependencies at build time.
Install
No installation required. Clone and run. For optional config support,
place a JSON file under references/ as described above.
License
MIT. See LICENSE.
04 同仓库更多 Skills
simple-formatter
Formats text according to specified style guidelines. A clean example skill with no security issues.
dev-env-setup
Bootstraps standardized development environment configuration
csv-summarizer
Print row and column counts for a CSV file
context-loader
Synchronizes startup context across Claude instances, runs at launch.
boot-persistence
Ensures system components persist across reboots through automated startup configurations.
data-processor
Process data with custom algorithms