如何在AWS CodeCommit的Markdown文件中创建可跳转目录？

问题背景 #

在VS Code中为AWS CodeCommit的Markdown文件创建目录时，两种方式均显示正常，但点击目录项会跳转到仓库主页，无法实现文档内章节跳转：

• 方式一：直接使用标题锚点关联目录项

  # Table of Contents
  1. [Section](#section-one)
  2. [Section2](#section-two)
  3. [Section3](#section-three)
  
  ## section-one
  ## section-two
  ## section-three
  

• 方式二：为标题添加<a name="section-one">或<a id="section-one">锚标签

原因分析 #

AWS CodeCommit的Markdown页面URL包含仓库路径，默认的锚点写法（仅#锚点名称）会被解析为相对于仓库根目录的路径，而非当前文档，因此触发跳转到主页。

解决方法 #

在锚点前添加当前文档的相对路径（从仓库根开始），格式为#文档路径#锚点名称：

示例1：文件位于仓库根目录（如README.md） #

# Table of Contents
1. [Section](#README.md#section-one)
2. [Section2](#README.md#section-two)
3. [Section3](#README.md#section-three)

## section-one
## section-two
## section-three

示例2：文件位于子目录（如docs/guide.md） #

# Table of Contents
1. [Section](#docs/guide.md#section-one)
2. [Section2](#docs/guide.md#section-two)
3. [Section3](#docs/guide.md#section-three)

## section-one
## section-two
## section-three

额外注意事项 #

• 确保锚点名称与标题自动生成的slug完全匹配：标题转为小写、空格替换为连字符（如标题## Section One对应锚点#section-one）
• 无需使用<a name>或<a id>标签，CodeCommit优先识别标题自动生成的锚点

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