markdown-toc

Generate a table of contents by running the script on your Markdown file. The Skill automatically creates a TOC with GitHub-compatible anchors, detects header levels, skips code blocks, and preserves YAML frontmatter. Use insertion modes like auto, top, or marker-based placement to control where the TOC appears.

Yes, the Skill supports batch processing using glob patterns and recursive directory scanning. Process entire projects or targeted file sets in a single run, with configurable header level ranges to control which headers are included in each file's TOC.

You can configure which header levels to include in your TOC. The Skill lets you specify a range—for example, H2 through H3—so you control the depth and granularity of your generated table of contents.

Use the dry-run mode to preview the generated table of contents before it's inserted into your files. This lets you verify the TOC structure, anchor generation, and insertion placement without modifying your Markdown documents.

Yes, the Skill detects and skips existing TOC headers to avoid duplication. It also respects YAML frontmatter and code blocks, ensuring only actual document structure is indexed and your metadata and code samples remain untouched.

The Skill has no hard dependencies, making it portable across environments. It runs as a standalone script with no external packages required, so you can use it immediately without additional setup or installation steps.