Markdown锚点跳转失败的办理办法

Markdown 标题含特别字符时，自动天生的锚点 ID 大概与目次链接不划一，用  标签手动界说锚点即可办理。

目次

• 前情提要
  
• 分析题目
  
• 办理方法
  
• 结果
  

前情提要

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

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

复制代码

博文正文标题：

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

复制代码

分析题目

题目在于：目次里写的锚点 #五快速前缀--三板斧 和 Markdown 渲染器根据标题自动天生的 HTML id 不划一，导致点击目次链接时找不到目的位置。
标题中含有 /、!、@ 等特别符号，渲染器在天生锚点时会如那边理这些字符？——大概直接删除，也大概更换为 -，以致编码成其他情势。总之，锚点对不上，自然无法跳转。
那么，怎样正确获知实际的 id？一个更可控的办法是：不依靠自动天生，本身指定。
办理方法

在标题上方放置一个  标签，手动界说锚点 ID：

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

复制代码

目次中直接引用这个自界说 ID：

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

复制代码

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

点击目次中"五、快速前缀：/ ! @ 三板斧"，可以正常跳转到正文了。

免责声明：如果侵犯了您的权益，请联系站长及时删除侵权内容，谢谢合作！qidao123.com:ToB企服之家，中国第一个企服评测及软件市场,开放入驻,技术点评得现金.