📜  如何在 readme.md 中创建指向同一文件的链接 (1)

📅  最后修改于: 2023-12-03 15:24:22.389000             🧑  作者: Mango

如何在 README.md 中创建指向同一文件的链接

在编写说明文档时,经常需要在 README.md 文件中创建链接到同一文件中的其他部分。以下是几种方法:

方法一:使用标题

在 README.md 文件中,为每个部分添加标题,然后在要链接到的部分使用相应的标题名称作为链接。如下所示:

# 标题一

这是标题一的部分。

## 子标题

这是标题一的子标题部分。

## 链接

要链接到子标题部分,请使用以下链接:

[链接到子标题部分](#子标题)

这将创建一个指向子标题部分的链接。在链接中,# 符号和空格将标题名称转换为一个锚点名称。这种方法非常简单,但存在一个问题,如果重命名了标题,所有相应的链接将失效。

方法二:使用 HTML 锚点

除了使用标题名称外,还可以使用 HTML 锚点来创建链接。为了创建一个锚点,可以在文本中插入一个包含 id 属性的 HTML 元素。例如:

# 标题一

这是标题一的部分。

## 子标题

这是标题一的子标题部分。

<a id="some-id"></a>

## 链接

要链接到锚点,请使用以下链接:

[链接到锚点](#some-id)

这将创建一个指向名为 "some-id" 的锚点的链接。使用这种方法,即使标题重命名,链接也不会失效。

方法三:使用 Github 基础 URL 和文件路径

在 Github 上,每个文件都有一个唯一的 URL。可以使用基础 URL 和文件路径来创建指向同一文件的链接。例如:

# 标题一

这是标题一的部分。

## 子标题

这是标题一的子标题部分。

## 链接

要链接到子标题部分,请使用以下链接:

[链接到子标题部分](README.md#子标题)

这将创建一个指向子标题部分的链接。在链接中,README.md 指的是当前文件,# 符号和空格将标题名称转换为一个锚点名称。这种方法适用于本地文件和在线文件。

无论哪种方法,都可以使 README.md 文件中的链接指向同一文件中的其他部分。根据需要选择其中一种方法即可。