Markdown 目录生成是什么
长文档需要目录导航,手写既慢又容易在改标题后失效。自动提取标题 + 生成锚点链接是最省事的做法。
这个工具能做什么
- 自动提取 H1-H6 标题,可限制层级
- 三种锚点风格:GitHub、通用、原样
- 跳过一级标题,列表符号可选
- 自动处理代码块与重复锚点
怎么使用(输入说明)
- 粘贴 Markdown 文档
- 设置收录层级与锚点风格
- 在目录结构里核对
- 复制 Markdown 源码
使用时的几个注意点
- 代码块里的注释不会被误判
- 锚点风格不对就换一种再试
- 跳过一级标题可以避免目录里出现文章大标题
实例
一篇含 5 个二级标题、8 个三级标题的文章,勾选收录到 H3,生成 13 条带锚点的目录。
常见问题 FAQ
Q:代码块里的 # 会被当成标题吗?
A:不会。工具会识别三个反引号或波浪号组成的代码围栏,围栏内的内容一律跳过。
Q:生成的锚点点了跳不动怎么办?
A:各家平台生成锚点的规则不一样。GitHub、掘金、知乎、微信公众号各有各的实现。遇到跳不动就把锚点风格切成「原样」再试一次。
Q:重复标题怎么处理?
A:工具会自动检测重复锚点,第二个相同的标题后面加 -1,第三个加 -2,避免链接冲突。