Markdown目录生成器

自动扫描 Markdown 标题并生成带 GitHub 风格锚点的多级目录，支持层级控制和插入文件顶部。

为 Markdown 文档自动生成带锚点链接的目录（TOC）。纯标准库，本地运行。

功能

• 扫描 #~###### 标题，按层级生成目录
• 自动生成 GitHub 风格锚点（英文/数字/连字符，忽略标点）
• 支持指定最大层级（如只取到 ###）
• 可插入到文档顶部，或单独输出

依赖

无（Python 标准库）

使用方法

bash

# 生成目录并预览
python3 scripts/md_toc.py 文章.md

# 插入到文件顶部（带占位符 <!-- TOC -->）
python3 scripts/md_toc.py 文章.md --insert

# 只取到三级标题
python3 scripts/md_toc.py 文章.md --max 3

适用场景

• 长文 / 文档 / 知识库自动生成导航
• 公众号 / 博客文章加目录
• 飞书文档 Markdown 导入前处理

📊 相关服务：品牌 AI 搜索存在感免费检测

做品牌 / 营销 / 内容，你的品牌在 AI 搜索里"被看见"了吗？

AISoBrand 免费检测：看你的品牌在豆包 / 千问 / 元宝 / 文心 / Kimi / DeepSeek 的 AI 搜索里有没有名字、排第几。

👉 免费检测：https://aisobrand.com/free-diagnosis