跳到主要内容

Markdown 目录生成

一键生成文章锚点目录

识别到 3 个标题
目录结构
  • H2 二级标题#二级标题
  • H3 三级标题#三级标题
  • H2 另一个二级标题#另一个二级标题

代码块里的 # 注释不会被误判成标题。生成的锚点尽量对齐 GitHub 的规则, 但各家平台(知乎、掘金、微信公众号)的实现有细微差别,粘贴后如果点不动, 把锚点风格切成「原样」再试一次。全部在本地完成。

Markdown 目录生成是什么

长文档需要目录导航,手写既慢又容易在改标题后失效。自动提取标题 + 生成锚点链接是最省事的做法。

这个工具能做什么

  • 自动提取 H1-H6 标题,可限制层级
  • 三种锚点风格:GitHub、通用、原样
  • 跳过一级标题,列表符号可选
  • 自动处理代码块与重复锚点

怎么使用(输入说明)

  1. 粘贴 Markdown 文档
  2. 设置收录层级与锚点风格
  3. 在目录结构里核对
  4. 复制 Markdown 源码

使用时的几个注意点

  • 代码块里的注释不会被误判
  • 锚点风格不对就换一种再试
  • 跳过一级标题可以避免目录里出现文章大标题

实例

一篇含 5 个二级标题、8 个三级标题的文章,勾选收录到 H3,生成 13 条带锚点的目录。

常见问题 FAQ

Q:代码块里的 # 会被当成标题吗?

A:不会。工具会识别三个反引号或波浪号组成的代码围栏,围栏内的内容一律跳过。

Q:生成的锚点点了跳不动怎么办?

A:各家平台生成锚点的规则不一样。GitHub、掘金、知乎、微信公众号各有各的实现。遇到跳不动就把锚点风格切成「原样」再试一次。

Q:重复标题怎么处理?

A:工具会自动检测重复锚点,第二个相同的标题后面加 -1,第三个加 -2,避免链接冲突。

常见问题

代码块里的 # 会被当成标题吗?
不会。工具会识别三个反引号或波浪号组成的代码围栏,围栏内的内容一律跳过。
生成的锚点点了跳不动怎么办?
各家平台生成锚点的规则不一样。GitHub、掘金、知乎、微信公众号各有各的实现。遇到跳不动就把锚点风格切成「原样」再试一次。
重复标题怎么处理?
工具会自动检测重复锚点,第二个相同的标题后面加 -1,第三个加 -2,避免链接冲突。