Markdown锚点跳转失败的解决办法

前情提要

在浏览我前几天的一篇博文《Claude Code 终端高效使用指南》时，发现从目录链接无法跳转到标题"五、快速前缀：/!@三板斧"。

博文目录中的写法：

- [五、快速前缀：`/` `!` `@` 三板斧](#五快速前缀--三板斧)

博文正文标题：

## 五、快速前缀：`/` `!` `@` 三板斧

分析问题

问题在于：目录里写的锚点#五快速前缀--三板斧和 Markdown 渲染器根据标题自动生成的 HTMLid不一致，导致点击目录链接时找不到目标位置。

标题中含有/、!、@等特殊符号，渲染器在生成锚点时会如何处理这些字符？——可能直接删除，也可能替换为-，甚至编码成其他形式。总之，锚点对不上，自然无法跳转。

那么，如何准确获知实际的id？一个更可控的办法是：不依赖自动生成，自己指定。

解决方法

在标题上方放置一个<a>标签，手动定义锚点 ID：

<a id="five-fast-prefix"></a> ## 五、快速前缀：`/` `!` `@` 三板斧

目录中直接引用这个自定义 ID：

- [五、快速前缀…](#five-fast-prefix)

你也可以用中文作为id，比如id="五快速前缀"，但要确保没有空格和特殊符号。

效果