visual-studio-code - 同名但不同部分的Markdown anchor 链接

Question

您可以很容易地链接到 Markdown 中的 anchor 标题。[link to anchor heading](#background)
很多 stackoverflow 问题都会处理它，例如这个 one 或这个 one 。

但我似乎无法找到一种方法来链接到共享相同名称但位于不同部分的 anchor 。

例如，我无法链接到不同部分中的背景部分。[link to database background](#database#background)
而不是说:[link to front end background](#front-end#background)
这也不起作用。[link to database background](#database##background)
我希望 Markdown anchor 链接遵循指定的部分路径。这不可能吗？还是我使用了错误的语法？

Answer 1

据我所知，没有支持指定 section-subsection-... 格式的 Markdown 规范。据我了解，它们被转换为类似 <a name=header>header</a> 的链接，并且没有关于父 header 是什么的信息。

我使用的一种解决方法是，当标题名称重复时，它会附加一个 -1 ，以便您可以使用 #header-1 进行访问。相同的模式应用于下一个副本 ( #header-2 ) 和下一个 ( #header-3 ) 等等。

这是一个示例 Markdown (在 VS Code 1.38.1 上工作):

# App

[module 1 background](#background)

[module 2 background](#background-1)

[module 3 background](#background-2)

## Module 1

### background

## Module 2

### SubModule 2-1

#### SubSubModule 2-1-1

##### background

## Module 3

### background

此解决方法的问题在于您必须跟踪重复名称的顺序，如果您有很多重复名称，这会变得非常乏味。好处是创建指向嵌入在一系列标题中的重复名称的链接更容易( #background-1 比 ##module2###submodule-2-1####subsubmodule-2-1-1#####background 更容易)。

我不知道究竟是如何或为什么会这样，但 VS Code 正在使用 CommonMark 规范和 markdown-it 库来解析它，如 Markdown editing 文档中所述。