Markdown TOC 生成后，还要留意标题改名

Markdown 目录自动生成刚用起来时，体验通常都很好。
大纲一键出来，长文章可读性立刻上去，写作者自己也更容易把结构收住。但 2017 年我在持续写技术文档和博客时，慢慢发现目录真正麻烦的地方，不在生成那一刻，而在后面你继续润色标题的时候。

因为标题一改，锚点就很可能跟着变。

为什么这件事容易被忽略

因为目录看上去像“自动产物”，让人天然觉得它会一直自己保持正确。
可实际上，大多数目录工具只是按当前标题生成一遍，并不会替你理解后续改名对历史链接、外部引用和正文内部跳转的影响。

于是很常出现这种情况：

• 目录还在
• 页面也能打开
• 但原来收藏的锚点失效了
• 文内引用跳转错位了

我后来对目录的理解

目录不是单纯的排版小功能，它其实是在给文章生成一套“内部地址”。
既然是地址，就要意识到改标题不只是改文案，也是在改路由的一部分。

尤其技术文章常常会被别人引用具体章节，这时稳定性就更重要。

我现在更愿意怎么做

如果只是润色语气，我会优先看能不能不动核心标题关键词。
如果确实要大改标题，我会额外检查：

• 目录跳转是否还准确
• 文内链接是否需要同步更新
• 外部常引用的章节是否值得保留旧锚点习惯

这些动作不复杂，但能明显降低“看起来没问题，实际上跳不准”的尴尬。

小结

Markdown TOC 真正难的不是生成，而是维护。
2017 年之后我对这类工具的态度更现实了：自动生成当然省事，但标题一旦改名，就得把锚点稳定性也算进去。目录不是一次性特效，而是文章结构的一部分。