Markdown 目录生成器

问题：长 Markdown 文档缺目录

当文档从十几行膨胀到几百行后，# 到 ###### 标题散落在正文中，读者很难快速定位章节，作者也要手工整理目录并反复维护。若文档里有重复标题、行内格式或代码块示例，简单正则很容易误判，也可能生成不可点的锚点。

工作方式：按标题生成可插入 TOC

markdown-toc 从 Markdown 文件中提取标题，并生成适合插回正文的目录。核心能力包括：

• 识别 # 到 ###### 的 1-6 级标题；
• 支持 bullet list 与 linked 两种目录格式；
• 可按标题级别过滤，输出更紧凑的结构；
• 为重复标题生成唯一锚点，避免链接失效；
• 保留标题中的粗体、斜体、行内代码等格式；
• 跳过代码块内看似标题的文本，降低误提取概率。

适用边界

它面向已有标准 Markdown 标题的文档生成目录，不负责重排文档结构，也不会自动修复非标准标题。若标题层级混乱或章节命名不规范，目录可读性仍受原文限制。