Markdown 目录生成器
为 Markdown 文档自动生成带锚点链接的目录(TOC)。纯标准库,本地运行。
功能
- 扫描
#~######标题,按层级生成目录 - 自动生成 GitHub 风格锚点(英文/数字/连字符,忽略标点)
- 支持指定最大层级(如只取到
###) - 可插入到文档顶部,或单独输出
依赖
无(Python 标准库)
使用方法
# 生成目录并预览
python3 scripts/md_toc.py 文章.md
# 插入到文件顶部(带占位符 <!-- TOC -->)
python3 scripts/md_toc.py 文章.md --insert
# 只取到三级标题
python3 scripts/md_toc.py 文章.md --max 3
适用场景
- 长文 / 文档 / 知识库自动生成导航
- 公众号 / 博客文章加目录
- 飞书文档 Markdown 导入前处理
评论
加载中…