Markdown 常用语法

本文用于记录 Markdown 的语法。

TODO

添加页内跳转(锚点链接)

如果一篇文章很长,没有目录会导致阅读起来很不方便,添加页内跳转(也叫锚点链接)可以解决这个问题。

创建锚点

有几种创建锚点的方式,使用哪种方式都可以,只是在显示上可能有些差别:

1
2
3
4
[create an anchor](#anchors-in-markdown)
<a id="anchors-in-markdown">create an anchor</a>
<div id="anchors-in-markdown">create an anchor</div>
<span id="anchors-in-markdown">create an anchor</span>

这个 anchors-in-markdown 通俗的理解就是一个 key,跳转锚点时就是根据这个 key 来找到对应锚点的,因此这个值必须是唯一的。这个值可以是中文,但必须保证唯一性。通常我们一般都是在章节标题这些地方使用锚点,目的是方便用户快速查看某个章节的内容。

比如:我想给上面的 “添加页内跳转(锚点链接)” 这个章节创建一个锚点,那么可以这样写:

1
2
3
4
[添加页内跳转(锚点链接)](#add_anchor_in_page)
<a id="add_anchor_in_page">添加页内跳转(锚点链接)</a>
<div id="add_anchor_in_page">添加页内跳转(锚点链接)</div>
<span id="add_anchor_in_page">添加页内跳转(锚点链接)</span>

访问锚点

访问锚点的方式都是一样的:

1
[visit an anchor](#anchors-in-markdown)

比如我想访问 “添加页内跳转(锚点链接)” 这个锚点,那么就需要这么写:

1
[跳转到 “添加页内跳转(锚点链接)”](#add_anchor_in_page)

[] 中的描述内容可以随意写,只要在 # 后面添加想要访问的锚点名称就行了。

演示锚点

首先创建四个标题:

标题1

标题2

标题3

标题4

点击文字跳转到锚点:
点击 我是标题1的锚点 跳转到“标题1”小章节。
点击 我是标题2的锚点 跳转到“标题2”小章节。
点击 我是标题3的锚点 跳转到“标题3”小章节。
点击 我是标题4的锚点 跳转到“标题4”小章节。

因为只是演示,所以不会看到明显的界面跳转。在实际使用时,如果锚点和访问点已经无法在电脑屏幕上同时显示,那么点击访问点可以看到页面会自动跳转锚点那。

差别

从此页面 hexo 支持的博客渲染效果来看,[create an anchor](#anchors-in-markdown) 和 使用 a 标签创建的锚点,会在锚点的描述文字底部显示一条线 ,表示这是个链接。而使用 divspan 标签创建的锚点不会显示链接的标志。