松学透Markdown的终极教程 #3： Markdown标准标记语法（全）

掌握并熟记一些常用的Markdown的标记语法，简单、有趣、实用

其实如果大家选择了一款Markdown编辑器上手的话，这些Mardown编辑器里都会带有Markdown的标记语法的说明和提示。

【▲ 部分图片截自Ulysses软件和MacDown软件】

通过这些软件里的简要语法说明，大家也能够很快的学会Markdown的标记语法并应用到实际的文字工作中去。

同时网络上也有很多的标记语法语法讲解，有Markdown官方的语法介绍网站（文末附录有链接），也有很多其他人分享的Markdown标记语法教程。

这里我给大家做了一张「简单明了」的标准的Markdown标记语法速查图，一图即可看懂Markdown语法标记：

可能图片上传后压缩失真模糊了，可以关注我们的公众号「远怀学堂」，回复209即可下载到此图的高清1080P大图，方便快速查询学习标准的Markdown标记语法

如果你看上面这张图就已经完全懂了，那你可以不需要继续阅读下去了，下文是对这些语法做更加详细的解读，内容较细，建议看下去，你也可以只看你关心的那部分「标记语法」。

我会结合实际的应用场景给大家细讲这些标记语法，本系列教程中会给大家讲到应用非常广泛的两种Markdown标记语法：「标准的Markdown标记语法」和「GFM（GitHub Flavored Markdown）语法」，同时会对实际应用中的重难点标记语法「图片、链接」给大家做更加详细、明了、深入的讲解，让大家完全学透Markdown。

3.1 不同的语法之分

Markdown语言是John Gruber 在 2004 年创造的，由他一开始提出来的Markdown标记语言规则可以看做是「标准的Markdown标记语法」。

标准的Markdown中提供的标记语法相对简单且较少，后来随着时间的推移，使用Markdown的人越来越多，不同的人有不同的使用需求，最初提出来的Markdown标记语法已经满足不了很多人不同的需求了，因此有很多人提出了对最初的Markdown标记语法进行扩展并进行标准化，但是Markdown的创始人Gruber认为不应完全标准化。

“不同的网站（和人们）有不同的需求。没有一种语法可以让所有人满意。” —Gruber

所以后来很多的组织自行的在「标准的Markdown」的标记语法上进行扩展，增加了些新的标记语法，其中最有名的当属GitHub发布的基于CommonMark的GitHub Flavored Markdown（GFM）标记语法。

「标准的Markdown标记语法」和「GFM标记语法」在我们这个系列教程中都会给大家讲到。

3.2 好吧，那我们开始标准的标记语法学习

首先强调一点的是：所有的标记语法都是在英文输入法状态下输入的，这点一定要注意。

Markdown格式的文档的后缀名一般为.md或者.markdown

3.2.1 最常用到的标记

「标题」、「加粗」、「强调」

每当我们去写一篇文章时，经常需要构思出这篇文章的目录层次结构：文章的一级大标题、二级标题、三级标题、四级标题等。

【▲ 由本Markdown文档导出成Word后截的大纲图示】

拥有良好的目录层次结构的文章编写和阅读起来都很清晰，在Markdown中可以使用「标题」标语语法来实现这种文章的目录层次结构。

「标题」

【标记语法】

# 文章大标题（一级标题）
## 第1章节 章节名（二级标题）
### 1.1 小节名（三级标题）
## 第2章节 章节名（二级标题）
### 2.1 小节名（三级标题）
#### 2.1.1 小节名（四级标题）

注意标记符号 # 号后面需要有个空格

对应的最终渲染显示效果：

标记语法显示效果是在MacDown软件运行的，下同

一篇文章应该有且只有一个「一级标题」，为该文章的大标题，「一级标题」下面可以有多个「二级标题」，「二级标题」下面可以有多个「三级标题」，「三级标题」下面可以有多个「四级标题」，以此类推下去，在Markdown中最多使用6个#号代表「六级小标题」，这6个层级的目录标记语法也够我们平时做文章用了，一般也用不了那么多层级的。

当我们想要对文章中的某些文字加以强调，可以使用「加粗」和「强调」的标记语法。

「加粗」

【标记语法】

**需要加粗的文字** 或者__需要加粗的文字__

对应的最终渲染显示效果：

「强调」（「斜体」）

【标记语法】

*需要强调显示的问题* 或者 _需要强调显示的问题_

对应的最终渲染显示效果：

3.2.2 最清晰的标记

「有序列表」、「无序列表」、「分隔线」

当我们有一项一项的条目需要列出来表达时，可以试试Markdown中的「列表」标记语法，其中也分为「有序列表」、「无序列表」。

「有序列表」

【标记语法】

1. 有序列表项1
2. 有序列表项2
3. 有序列表项3

以数字开头，后面紧跟一个.号，再加上一个空格（1. ）就组成了「有序列表」的标记语法

标记语法的开头的数字并非一定要1 2 3这样次序下去，只要是数字即可，也可以使用下面的表达方式

1. 有序列表项1
1. 有序列表项2
6. 有序列表项3

对应的最终渲染显示效果：

「 无序列表」

【标记语法】

- 无序列表项1
- 无序列表项2
- 无序列表项3

以-开头，加上一个空格构成了「无序列表」的标记语法，其中-也可以使用*或+代替

* 无序列表项1
* 无序列表项2
* 无序列表项3

对应的最终渲染显示效果：

「有序列表」和「无序列表」都能够通过一个一个列表项的效果很清晰、有条理的表达出意思。

这两者最大的区别就是「有序列表」标记语法最终显示时每个列表项前面有个有次序的数字，「无序列表」标记语法最终显示时是以小黑点作为列表项的开头，以表示无序的意思。

「 列表的嵌套」

「有序列表」和「无序列表」也可以实现列表嵌套：

【标记语法】

1. 有序列表项1

	- 无序列表1
	- 无序列表2
	- 无序列表3
2. 有序列表项2
3. 有序列表项3


- 无序列表1

	1. 吃饭
	2. 睡觉
	3. 打豆豆
- 无序列表2

	> 我是一个引用
- 无序列表3

	我是一个段落

对应的最终渲染显示效果：

使用一个TAB（制表符）或者4个空格来实现在某个列表项下面嵌套其他内容，同时需要在该列表项下加上一个空行（有些软件可能不需要这么做）。

要实现更多层次的嵌套效果可以使用更多TAB去控制嵌套的层次关系，但是我也不推荐大家嵌套的层次过多（最多也就一层嵌套关系），嵌套层次过多反而将内容的显示变得显得复杂难懂，同时在写标记语法时也容易出错。

「分隔线」

「分隔线」标记语法，可以在两段内容之间增加一条水平的分隔线，分隔内容，清晰表达。

【标记语法】

***
或者
---
或者
___
或者
* * *
或者
*********

使用3个或3个以上的*号或者-号或者_号，可以建立一条水平的分隔线，这一行内不能有其他内容，但是在多个*（或-、_）之间插入空格。

对应的最终渲染显示效果：

3.2.3 最网络的标记

「链接」、「自动链接」、「引用」

「链接」

我们平时浏览网页时，网页上的各种超链接将各种关联的信息链接在了一起，我们点击一个页面上的一个链接可以将我们导航到另一个页面上去，这些链接构成了内容丰富的互联网世界，链接可以说是互联网的基石了。

在文档中插入链接，让更多的信息关联在一起，比如我们想去做一个旅游攻略时，可以将一些有用的网络上有价值的链接记录在攻略中。

在Markdown中可以轻松实现网页上的超链接的效果，因为Markdown就是在网络环境中被创造出来的。

「链接」标记语法有两种形式： 「行内式的链接」和「参考式的链接」。

【行内式的链接标记语法】

我们的官方网站是：[远怀学堂](https://www.yuanhuaixuetang.com)

我们的官方网站是：[远怀学堂](https://www.yuanhuaixuetang.com "远怀学堂官方网站")

对应的最终渲染显示效果：

行内式的链接语法是[]()，方括号里是链接的文字，圆括号里是链接的URL地址，URL地址后面还可以加一个空格再使用一对双引号包裹一个链接显示的title，也就是鼠标悬停在该链接上时显示的title文字，这个title是可选的。

圆括号里的URL地址可以使形如http/https开头的主机绝对 URL地址，也是是形如/index.html，../about.html，../a/download.html，/a/b/c.png的路径地址，这种路径地址是基于当前的Web主机或者当前markdown文档所在目录的地址。

【标记语法】

[图片1][./1.png]
[图片1][1.png]
[关于我们][/about.html]
[联系我们][../contact.html]

使用这种路径地址，情况就有点点复杂：

1.如果Markdown文档是在本地电脑上编辑的话：

[图片1][./1.png]    1.png需要存放在当前Markdown文档在同一个目录下

[图片1][1.png]    与上相同，./开头可以省略

[关于我们][/about.html]  about.html需要存放在当前电脑的根目录下（/代表的是MacOS或者Linux系统的根目录）

[联系我们][../contact.html]  contact.html需要存放在当前Markdown文档所在目录的上一层目录中

2.如果Markdown文档渲染之后的html页面存放在Web主机上的话，那么这些路径地址指的是：

[图片1][./1.png]    1.png需要存放在当前html页面同一个目录下

[图片1][1.png]    与上相同，./开头可以省略

[关于我们][/about.html]  about.html需要存放在Web主机的根目录下

[联系我们][../contact.html]  contact.html需要存放在当前html页面所在目录的上一层目录中

./（可省略）开头的地址指当前文件所在的目录，一般也是可以省略掉的，../开头的地址指当前文件的上一层目录。它们是以某个点（一般是以当前Markdown文档所在的目录或者当前主机）作为参考，一步一步索引到目标文件的路径。

/开头的地址指的是文件所在环境（本地电脑或Web主机）的根目录，如果是本地电脑的话，/指的是本地电脑文件系统的根目录，如果是Web主机的话，/指的是Web主机环境中Web应用程序（Apache、nginx等）配置的Web根目录。

【参考式的链接标记语法】

我们的官方网站是：[远怀学堂][a]

我们的官方网站是：[远怀学堂][1]

[a]: https://www.yuanhuaixuetang.com
[1]: https://www.yuanhuaixuetang.com "远怀学堂官方网站"

对应的最终渲染显示效果：

参考式的链接标记语法是2部分组成的：

第一个部分是由[][]构成的，第一个方括号里是链接的文字，第二个方括号里填写的一个id标识符，该id标识符可以是数字或者字母，同时该id标识符与标记语法的第二部分中的id是相同的内容

第二个部分是由[id标识符]: URL地址 "可选的title"构成的，这个部分可以放置Markdown文档的任意位置，但是我推荐将这些统一放置文档的末尾处，好统一管理。这个部分别忘了[id标识符]:冒号后面有一个空格。

我推荐大家尽量去使用「行内式的链接」标记语法，因为使用起来更加的简单明了。

「自动链接」

「自动链接」可以看作是「链接」（行内式、参考式）的一种特殊的简化形式。

当我们想在文档中处理裸的网址链接或者邮箱地址时，可以使用「自动链接」这种简化的标记语法。

我们先来看下使用「行内式链接」来标记裸的网址链接或邮箱地址：

【标记语法】

[https://www.yuanhuaixuetang.com](https://www.yuanhuaixuetang.com)

[support@yuanhuaixuetang.com](mailto:support@yuanhuaixuetang.com)

对应的最终渲染显示效果：

鼠标点击support@yuanhuaixuetang.com这个链接时会自动调用电脑中邮件程序，准备要向该地址发送邮件

使用「行内式链接」去标记这种裸的网址或者邮箱地址，需要在标记语法里重复写网址或者邮箱地址，通过「自动链接」的语法可以简化上述的写法：

【标记语法】

<https://www.yuanhuaixuetang.com>

<support@yuanhuaixuetang.com>

对应的最终渲染显示效果：

「引用」

「引用」标记是用来对文档中引用的别人的内容的一种标记。

我们在写文章或者论文之类的经常会引用到别人的一些内容，这个时候最好将引用别人的内容标记出来，这样也可以体现出我们所写的文章或论文的权威性，同时也是对原作者的尊重和认可。

每种格式的文档对引用别人内容的标识不同，像一般专业的论文写作，需要对引用的内容在右上角用小数字标识出来，同时在论文的结尾处按一定的格式要求给出所引用内容的出处。

在Markdown中标记出文章中所引用的内容是很简单的，同时要求也没那么严格，大家可以很自由的去使用。

【标记语法】

> 我是引用的别人的一句话

我不是引用内容

> 我是引用的别人的一段内容1
> 我是引用的别人的一段内容2
> 我是引用的别人的一段内容3

「引用」语法只需要在所引用的内容前面使用一个>号去标记，在>号后面还需要加上一个空格。如果引用的是一整段内容，在每一行的开头都使用一个>号加上一个空格。

对应的最终渲染显示效果：

我们也可以在引用内容的后面指出引用内容的出处，可以在引用的内容后面使用上「链接」的标记语法：

【标记语法】

> 我是引用的别人的一句话 [远怀学堂](https://www.yuanhuaixuetang.com)

对应的最终渲染显示效果：

指出引用内容的出处可以使用更加标准的「脚注」标记语法，但是在标准的Markdown语法中并不支持「脚注」标记语法，在很多的Markdown编辑器中支持「脚注」语法

引用还可以嵌套一个引用，使用如下的语法：

【标记语法】

> 我是一个引用
> > 我是一个嵌套引用（两层嵌套）
> > > 我也是一个嵌套引用（三层嵌套）

注意每个>号后面都需要加上一个空格

对应的最终渲染显示效果：

引用的嵌套语法很简单，每多使用一个>号（后面需要加上空格），就可以实现多一层次的嵌套。

引用的嵌套可以实现一种特殊的显示效果，我觉得嵌套引用除了实现上图中的特殊的显示效果外没有啥具体的意义的。

引用标记语法还可以配合使用Markdown的其他标记语法，像标题、加粗、列表、代码等等。

【标记语法】

> # 我是一级标题

> 我是个**粗体**

> - 我是无序列表项1
> - 我是无序列表项2

> 我是个行内代码`System.out.println("Hello,World)`

对应的最终渲染显示效果：

【图 标记语法显示效果，MacDown软件运行】

引用标记语法主要是用于对文章中所引用内容的一个标记，但我们前面看到引用标记的显示效果有点特殊，大家也可以灵活的去使用「引用」标记去实现对文章中特定的内容实现引用的这种特殊显示效果，并非一定严格要求「引用」标记只能应用在引用别人内容上面。

【▲ 上图截自https://www.zybuluo.com/mdeditor】

Markdown中的「引用」的标记语法所呈现的显示效果默认是网页中的引用效果 ，一般是<blockquote></blockquote>标签包裹。

3.2.4 最难用的标记

「图片」

Markdown是一种纯文本格式的文档，要在纯文本格式的文档中直接插入图片、音频、视频这等多媒体文件是一件非常困难的事情，纯文本的编辑器中只能存放像汉字、字母、标点符号等键盘上可以直接打出来的内容。

像Word一类的应用并非是纯文本的编辑器，这些软件中是很容易插入图片、音频、视频等多媒体文件的。

但是图文并茂的文章总是有更多的人喜爱看，而且图片等多媒体文件的表达意思的能力更强，在Markdown中也是可以「插入」图片的，只不过使用起来有点点「难」。

「插入」图片，其实并非字面上的意思将图片插入到Markdown文档中去的，其实是一种「引用」的关系，关于这点我将在会后面给大家做更加详细的讲解

这里说的「难」不是指Markdown中使用图片的标记方法难，图片的标记语法也非常的简单，「难」的是对Markdown中「插入」图片的理解和将图片放置在哪里。

这里我们先给出在Markdown中「插入」图片的语法：

「 图片」

图片的标记语法和链接的标记方法相似，也分为：「行内式」和「参考式」。

【图片的行内式标记语法】

「插入」本地图片

![](1.png)

1.png需要与当前编辑的Markdown文件在同一目录下


「插入」网络图片 -- 头条的LOGO图片

![头条LOGO](https://lf3-cdn-tos.bytescm.com/obj/cdn-static-resource/toutiao/static/img/logo.271e845.png)

对应的最终渲染显示效果：

图片的行内式标记语法在「行内式链接」标记语法（[]()）前面加上一个!，形如，其中图片的描述文字可以省略不填，图片的链接地址可以是图片的本地地址，也可以是图片的网络地址。

【图片的参考式标记语法】

//图片的参考式标记语法

![][img1]

![][img2]

[img1]: 1.png
[img2]: https://lf3-cdn-tos.bytescm.com/obj/cdn-static-resource/toutiao/static/img/logo.271e845.png

对应的最终渲染显示效果与上演示类似。

图片的参考式标记语法是在「参考式链接」标记语法由2个部分组成的：

第一个部分是由![图片的描述文字][id标识符]构成的，第一个方括号里是，第二个方括号里填写的一个id标识符，该id标识符可以是数字或者字母，同时该id标识符与该标记语法的第二部分中的id是相同的内容

第二个部分是由[id标识符]: 图片的链接地址构成的，这个部分可以放置Markdown文档的任意位置，但是我推荐将这些统一放置文档的末尾处，好统一管理。这个部分别忘了[id标识符]:冒号后面有一个空格。

我推荐大家尽量去使用「行内式图片」的标记语法，因为使用起来更加的顺手、自然。

我这里不对「 图片」标记语法做更多的讲解，「图片」是Markdown中的一个难点，也是它的一个痛点，我将在下一节教程中对Markdown的痛点「图片」做一个专题讲解，通过专题带大家更加深入有效的去理解在Markdown中使用「图片」这个问题。

3.2.5 最程序员的标记

「行内代码」、「代码块」、「兼容HTML语法」

「行内代码」、「代码块」标记语法都是用来在文档中正确的标记显示出某种程序语言的代码，比如Java源代码、PHP代码片段、函数名称等等，这两个标记语法主是要来写和程序语言相关的文档时用得比较多，程序员朋友们写技术博客时会经常需要用到，其他的情形一般用得很少。

「兼容HTML语法」是指可以直接在Markdown中使用原生的HTML代码去实现不同标记效果，一般用于补充Markdown中没有实现的标记效果，需要一定的前端HTML代码的编写能力。

「行内代码」

「行内代码」标记语法是用来标记一行内的一小段代码。