如何在GitHub中链接到另一个Markdown文件的指定章节

问题场景 #

我管理着一个包含多个Markdown文档的项目，需要创建从一个文档到另一个文档指定章节的直接链接。例如想从document1.md链接到document2.md的目标章节，但当前写法仅能打开目标文档，无法自动滚动到指定章节：

document2.md中的目标章节代码：

## <span id="ELB_concept">content</span>

document1.md中的链接代码：

<a href="path to #section2 within document2">content</a>

解决方案 #

方法1：使用标准Markdown标题锚点（推荐） #

无需手动添加<span>标签，直接使用标准Markdown标题语法，渲染工具会自动为标题生成锚点ID（通常是标题文本的slug化版本，小写字母、连字符替代空格、移除特殊字符）：

document2.md中修改为：

## content

document1.md中使用Markdown链接语法（或HTML链接）：

[跳转到document2的content章节](document2.md#content)

或HTML版本：

<a href="document2.md#content">跳转到document2的content章节</a>

方法2：保留自定义锚点ID的写法 #

如果需要保留自定义的ELB_concept锚点ID，链接中的锚点值必须与目标ID完全匹配，而非#section2：

document1.md中修改链接为：

[跳转到ELB_concept章节](document2.md#ELB_concept)

或HTML版本：

<a href="document2.md#ELB_concept">跳转到ELB_concept章节</a>

方法3：注意路径与渲染工具兼容性 #

• 确保文件路径正确：如果document2.md在子目录中，路径需写为subdir/document2.md#ELB_concept，支持相对路径或绝对路径
• 验证锚点有效性：渲染后查看HTML源码，确认目标章节的ID是否正确，再调整链接中的锚点值
• 不同渲染工具（如VS Code预览、GitHub Pages、MkDocs）对锚点的处理略有差异，需根据实际使用工具调整写法

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