Gridea 中 Markdown文本目录生成、页内跳转

@[TOC](这里写自定义目录标题)

[toc]在 Markdown 中，自动生成目录非常简单，只需要在恰当的位置添加[TOC]符号，凡是以#定义的标题都会被编排到目录中。（Gridea的一些主题使用颜色较浅，不是很适应）

---

<a name="Mark"></a>   <!-- 在合适的位置插入这句话 -->
[Your text](#Mark)    <!-- 在合适的位置插入这句话 -->
在HTML和Markdown中，<a name="Mark"></a> 和 [Your text](#Mark) 结合使用可以创建一个锚点链接，允许用户点击一个链接跳转到文档中的特定位置。
这里是它们各自的作用：
<a name="Mark"></a>: 这是一个锚点（anchor）标签，它定义了一个名为 “Mark” 的位置。在HTML中，这通常用于标记一个特定的位置，使得可以链接到这个位置。在较新的HTML标准中，name 属性已经被 id 属性所取代，所以更现代的写法是 <a id="Mark"></a>。
[Your text](#Mark): 这是一个Markdown格式的链接，它创建了一个可点击的文本链接，当用户点击这个链接时，浏览器会跳转到文档中 id 或 name 为 “Mark” 的位置。#Mark 是一个锚点（fragment）URL，它指向当前页面的特定部分。
使用方法：
首先，在您想要链接到的位置插入锚点标签 <a id="Mark"></a>。这通常放在您想要跳转到的段落、标题或元素的旁边。
然后，在文档中的其他位置（可以是同一个页面，也可以是其他页面）创建一个指向该锚点的链接。在Markdown中，您可以使用 [Your text](#Mark) 的格式来创建链接。这里的 “Your text” 是用户可见的链接文本，而 #Mark 是链接的目标，指向之前定义的锚点。
示例：
假设您有一个很长的页面，您想要在页面的顶部创建一个链接，允许用户快速跳转到页面底部的某个部分。

Jump to the bottom

Bottom Section

This is the content you want to jump to.

---

[点击查看示例图](#特定位置的id)
<!-- Your page content here -->
<h2 id="特定位置的id">这里是您想要跳转到的标题</h2>
<p>这是您想要跳转到的内容描述。</p>
<img src="https://img-blog.csdnimg.cn/img_convert/2743c75804dadec5c9e1a63f4863a995.png" alt="示例图片" />
这个代码片段展示了在Markdown或HTML文档中使用锚点（anchor）来实现页内跳转的方法。这里的 <span id="示例图"></span> 创建了一个锚点，而 [页内自由跳转](#示例图) 创建了一个链接，允许用户点击后跳转到锚点所在的位置。
这里是它们各自的作用：
<span id="示例图"></span>: 这是一个HTML标签，span 是一个通用行内元素，通常用于对一段文本进行样式化。在这里，它通过 id 属性定义了一个锚点，名为 “示例图”。这个 id 属性值是唯一的，用于标识文档中的特定位置。
[页内自由跳转](#示例图): 这是一个Markdown格式的链接，它创建了一个可点击的文本链接。当用户点击这个链接时，浏览器会跳转到文档中 id 为 “示例图” 的位置。#示例图 是一个锚点（fragment）URL，它指向当前页面的特定部分。
使用方法：
首先，在您想要链接到的位置插入锚点标签 <span id="示例图"></span>。这通常放在您想要跳转到的内容旁边。
然后，在文档中的其他位置创建一个指向该锚点的链接。在Markdown中，您可以使用 [页内自由跳转](#示例图) 的格式来创建链接。这里的 “页内自由跳转” 是用户可见的链接文本，而 #示例图 是链接的目标，指向之前定义的锚点。
示例：
假设您有一个很长的页面，您想要在页面的顶部创建一个链接，允许用户快速跳转到页面中的一个图片示例。

点击查看示例图

这里是您想要跳转到的标题

这是您想要跳转到的内容描述。

---

[名称](#id)
# id
代码片段展示了在Markdown中创建一个锚点链接的基本结构。这个链接允许用户点击一个文本（在本例中为“名称”）跳转到文档中具有特定 id 的位置。
这里是它们各自的作用：
[名称](#id): 这是一个Markdown格式的链接，它创建了一个可点击的文本链接，当用户点击这个链接时，浏览器会跳转到文档中 id 为 “id” 的位置。#id 是一个锚点（fragment）URL，它指向当前页面的特定部分。
<a id="id"></a>: 这是一个HTML标签，它通过 id 属性定义了一个锚点，名为 “id”。这个 id 属性值是唯一的，用于标识文档中的特定位置。
使用方法：
首先，在您想要链接到的位置插入锚点标签 <a id="id"></a>。这通常放在您想要跳转到的内容旁边。
然后，在文档中的其他位置创建一个指向该锚点的链接。在Markdown中，您可以使用 [名称](#id) 的格式来创建链接。这里的 “名称” 是用户可见的链接文本，而 #id 是链接的目标，指向之前定义的锚点。
示例：
假设您有一个很长的页面，您想要在页面的顶部创建一个链接，允许用户快速跳转到页面中的一个特定部分。

点击这里跳转到目标

目标部分

这是您想要跳转到的内容。

---

目录

• 跳到1. 这是一级标题
  • 跳到1.1. 这是二级标题 1-1
  • 跳到1.2. 这是大写字母标题 QWER
    • 跳到1.2.1. 这是 空格测试标题

标题

1. 这是一级标题

1.标题链接格式为：一个#+被链接标题
2.标题链接中不能出现大写字母，大写字母用小写字母代替
3.标题链接中不能出现空格，空格用－代替。
4.目录排布由有序列表或无序列表控制
5.跳转与目录名无关，标题和标题链接符合规则即可

1.1. 这是二级标题 1-1

1.标题链接格式为：一个#+被链接标题
2.标题链接中不能出现大写字母，大写字母用小写字母代替
3.标题链接中不能出现空格，空格用－代替。
4.目录排布由有序列表或无序列表控制
5.跳转与目录名无关，标题和标题链接符合规则即可

1.2. 这是大写字母标题 QWER

1.标题链接格式为：一个#+被链接标题
2.标题链接中不能出现大写字母，大写字母用小写字母代替
3.标题链接中不能出现空格，空格用－代替。
4.目录排布由有序列表或无序列表控制
5.跳转与目录名无关，标题和标题链接符合规则即可

1.2.1. 这是 空格测试标题

1.标题链接格式为：一个#+被链接标题
2.标题链接中不能出现大写字母，大写字母用小写字母代替
3.标题链接中不能出现空格，空格用－代替。
4.目录排布由有序列表或无序列表控制
5.跳转与目录名无关，标题和标题链接符合规则即可