Markdown指向含连字符标题的内部链接被判定失效如何解决

问题原因 #

Markdown 没有统一的锚点生成标准，不同渲染器、链接检查工具对标题中特殊字符的处理逻辑存在差异：你遇到的情况就是部分工具会先删除标题中原有的连字符-，再将空格统一替换为连字符生成锚点，最终导致你按照原标题生成的锚点和工具识别的锚点不匹配。

解决方案 #

• 手动指定锚点ID（优先级最高，通用度最高） #

  目前主流的 Markdown 变体（包括 GitHub Flavored Markdown、MkDocs、GitLab flavored Markdown 等）都支持给标题手动绑定自定义锚点 ID，完全绕开自动生成规则的差异。
  你可以把目标标题修改为如下格式，自定义一个不会有歧义的锚点：

  ## Install GPU support in an on-premises environment {#install-gpu-support-on-prem}
  

  跳转链接直接对应你自定义的锚点 ID 即可：

  [Creating GPU enabled on premises configurations](#install-gpu-support-on-prem)
  

• 适配检查工具的锚点生成规则 #

  如果当前使用的环境不支持自定义锚点 ID，可以先确认工具的锚点转换逻辑：将目标标题内容按照工具的规则处理（大写转小写、原有连字符删除、空格替换为连字符），用最终生成的字符串作为锚点写进跳转链接即可。
  按照你描述的工具逻辑，对应锚点可以写为：

  [Creating GPU enabled on premises configurations](#install-gpu-support-in-an-onpremises-environment)
  

• 调整标题写法（兜底方案） #

  如果前两种方案都无法落地，可以直接把标题中的on-premises修改为on premises，和工具识别的标题格式对齐，之后按照常规空格转连字符的规则写锚点即可。

内容的提问来源于stack exchange，提问作者Russ Urquhart