关于Markdown，它可以说是程序员公认最好的文档语言了，没有之一！我相信经常写文章或者开发文档的大佬们都对其能生成简洁、大方、雅观的文档都深有体会，它的强大是毋庸置疑的。它编写的文档不但能生成html格式的文档，还可以生成pdf格式的文档。而且现在网上的在线编辑器几乎上都支持了Markdown语法。比如：Github、GitLab、掘金、简书、博客园、csdn、码云、有道云笔记…等等,这里就不在一一列举了。反正大家只要知道它很简洁、通用、强大就够了。

这是我以前学习Markdown语法的笔记，对着电脑无聊之下发现了其存在，而前不久还有一个朋友问我其语法，或许不会Markdown语法的同学还是有一部的。故而，这里整合以前自己的笔记分享给大家，希望大家会喜欢。

一、Markdown简介

既然我们用了它，就该对其有一个大概的了解

1.1、认识Markdown

Markdown 是一种轻量级的「标记语言」，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑，Markdown的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的HTML标记语言来说，Markdown可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。

它用简洁的语法代替排版，而不像一般我们用的字处理软件Word或Pages有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。

1.2、使用Markdown的好处

专注你的文字内容而不是排版样式。
轻松的导出 HTML、PDF 和本身的 .md 文件。
纯文本内容，兼容所有的文本编辑器与字处理软件。
可读，直观。适合所有人的写作语言。

二、Markdown语法规则

上面对Markdown有了一个基本的认识，并且对其使用的好处也介绍了几点。那么该怎样编写Markdown文档呢？请继续往下看…

2.1、标题

类似于word文档中的标题。并且该标题的级数对应于Html语言的标题标签级数。如<h1></h1>、<h2></h2>…

一级标题：使用1个`#`号。 例： # 一级标题  等价于html中的 <h1>一级标题</h1>
二级标题：使用2个`#`号。 例： ## 二级标题  等价于html中的 <h2>二级标题</h2>
三级标题：使用3个`#`号。 例： ### 三级标题  等价于html中的 <h3>三级标题</h3>
四级标题：使用4个`#`号。 例： #### 四级标题  等价于html中的 <h4>四级标题</h4>
五级标题：使用5个`#`号。 例： ##### 五级标题  等价于html中的 <h5>五级标题</h5>
六级标题：使用6个`#`号。 例： ###### 六级标题  等价于html中的 <h6>六级标题</h6>

举例说明：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

看下效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2.2、列表

在编写Markdown文档时，列表几乎上都会用到的，而列表可分为无序列表和有序列表两种，他们的语法都很简单

2.2.1、有序列表

要使用有序列表，只要在一段文字前加上序号即可。如1. xxx、2. xxx…，这里值得注意的是，序号后面跟上一个英文符号的点（.）,并且(.)后面有一个空格，不然无效。

举例说明：

1. 中国
2. 美国
3. 英国

看下效果

中国
美国
英国

2.2.2、无序列表

要是用无序列表，只要在一段文字前面加上特定的符号即可。这里的符号可以是(*、-、+)。如- xxx、+ xxx、* xxx。同样值得注意的是符号与文字之间有一个空格。

举例说明：

- 中国                 + 中国                 * 中国
- 美国      <===>      + 美国     <===>       * 美国
- 英国                 + 英国                 * 英国

上面三个符号的效果是一样的，并且可以混用。看下效果：

中国
美国
英国

2.2.3、有序列表和无序列表之间的混用情况

在实际编写中，可能会出现列表包含子列表的情况，也可能发生无序与有序列表之间嵌套的情况。这种情况下，只要在子列表的字段前面加上一个Tab键，即4个空格就行了。请看下面的实例。

1. 中国
    - 深圳
    - 上海
2. 美国
    - 纽约
    - 硅谷
3. 英国
    - 英格兰
    - 威尔士

看下效果：

中国
- 深圳
- 上海
1. 美国
- 纽约
- 硅谷
1. 英国
- 英格兰
- 威尔士

上面只演示了，有序列表嵌套无序列表的情况，其他的根据这个格式按照有序和无序列表的语法改动就行了。

2.3、引用

引用的使用：在一段文本的前面加上英文的右尖括号，即(>)符号。值得注意的是，>符号与文本之间有一个空格。

2.3.1、基本使用

举例说明：

> 我是引用文本

看小效果：

我是引用文本

2.3.2、嵌套引用

嵌套引用在一个引用文本中在引用其他的文本，也可以和列表一起使用

举例说明：

> 我是引用文本1
>   > 我是嵌套的引用文本1
>   > 我是嵌套的引用文本2
>   >   > 1. 在嵌套一层1   
>   >   > 2. 在嵌套一层2
>   >
>   > 我是嵌套的引用文本3
>
> 我是引用文本2

看下效果：

我是引用文本1
我是嵌套的引用文本1
我是嵌套的引用文本2
在嵌套一层1
在嵌套一层2
我是嵌套的引用文本3
我是引用文本2

2.4、文字的样式

在Markdown中，还提供了几种很常见的文字样式，比如：加粗、倾斜、删除线等。

2.4.1、加粗

在文本的两端分别加上两个星号（**）或者下划线（__）。比如**xxx**，注意:不能有空格

举例说明：

**我是加粗的文本1**
__我是加粗的文本2__

看下效果：

我是加粗的文本1
我是加粗的文本2

2.4.2、斜体

在文本的两端分别加上一个星号（*）或者一个下划线（_）。比如*xxx*，注意:不能有空格

举例说明：

*我是倾斜的文本1*
_我是倾斜的文本2_

看下效果：

我是倾斜的文本1
我是倾斜的文本2

2.4.3、删除线

在文本的两端分别加上两个波浪号（~~）。比如~~xxx~~，注意:不能有空格

举例说明：

~~我是要删除的文本~~

看下效果：

~~我是要删除的文本~~

2.4.4、下划线

在Markdown的原生语法中是不存在下划线的语法的，因为它会和链接产生冲突。在下面讲到Markdown引用链接时，你就明白了。但是我们可以用html代码达到下划线的效果。

2.4.4.1、解决方案：

使用行内Html代码解决,当然，上面的几种文本样式同样可以用Html去完成它。

2.4.4.2、使用行内`Html`代码解决的两种方式

使用Html标签中的<u></u>标签，但是这种方案不推荐，因为Html5的代码规范以及<u></u>标签的不可定制性。

举例说明：

<u>我是带有下划线的文本</u>

看下效果：

我是带有下划线的文本

使用Html语言中的<span></span>标签，相信对于前端开发者来说，是再熟悉不过了。推荐用此方式

举例说明：下划线为绿色，并且高度为1px，并且下划线为虚线。

<span style="border-bottom:1px dashed green;">所添加的需要加下划线的行内文字</span>

看下效果：

所添加的需要加下划线的行内文字

注意，要实现下划线为实线的话，请把dashed修改为solid

上面就是实现下划线的两种方式。

2.4.5、数学公式中的表达方法（很少用到）

用Markdown编写文档，用到数学公式的地方很少，我在这里列举常用的两三种，如果你想深入研究它，请参见在Markdown中输入数学公式(MathJax)这边文章，写的很详细

我在这里只举例说明数学公式中的上划线与下划线。

举例说明：

上划线：
        $\overline{X}$
下划线：
        $\underline{X}$

看下效果：

数学公式中的上划线：$\overline{X}$

数学公式中的下划线：$\underline{X}$

2.5、链接与图片

在实际的文档编写中，链接的引用于图片的插入都很重要，而且其使用度也很高。而且链接和图片在其语法上也只有一个细微的差别。请看下面的实例

2.5.1、链接

链接的使用：英文下的一对中括号[]来包裹住链接的文本，中括号后面跟上英文下的一对小括号()来包裹住链接的地址。比如：[百度](http://www.baidu.com)

举例说明：

[百度](http://www.baidu.com)
[掘金](https://juejin.im)

看下效果：

百度
 掘金

2.5.2、图片

图片的使用和链接的使用几乎相同，只要在[]前面加上一个英文的感叹号即可，即(!)符号。

举例说明：

![图片1](图片的连接)    
![图片2](图片的连接)

这里为了篇幅原因，就不举实例了，大家只要记住上面的用法就行了。
如果是在在线平台上插入图片，该平台一般会先上传你的图片后，该平台会给你生成该图片的链接地址。你用这个地址就可以了。

2.6、表格

Markdown中的实现表格是比较麻烦的。这里不多作解释，看下面的例子就知道了。

2.6.1、基本使用

举例说明：

|  列名1  |  列名2  |  列名3  |
|---------|---------|---------|
|  值1    |   值1   |  值2    |
|  值1    |   值1   |  值2    |
|  值1    |   值1   |  值2    |

看下效果：

列名1	列名2	列名3
值1	值1	值2
值1	值1	值2
值1	值1	值2

2.6.2、表格的对齐方式

默认的对齐方式为：左对齐方式。

举例说明：以上面的例子举例，第一列左对齐，第二列居中对齐，第三列右对齐。

注意和上面例子的不同之处

|  列名1  |  列名2  |  列名3  |
|:--------|:-------:|--------:|
|  值1    |   值1   |  值2    |
|  值1    |   值1   |  值2    |
|  值1    |   值1   |  值2    |

看下效果：

列名1	列名2	列名3
值1	值1	值2
值1	值1	值2
值1	值1	值2

2.7、关键字、代码块、多行文本、换行

在编写文档，特别是技术型文章的时候，关键字和代码框的使用尤其的多。这里对上面提到的4个知识点一一的讲解。

2.7.1、关键字

关键字的使用：在文本的两端分别加上英文的(`)这个符号。即键盘上Tab键的上面哪一个键。注意是英文的情况下。例：`xxx`、`yyy`

举例说明：

`关键字1`、`Java`、`Android`、`ios`

看下效果：

关键字1、Java、Android、ios

2.7.2、代码块

代码框的使用：在一段文本的前面加上4个空格，或者一个Tab键的长度。

举例说明：

注意看下面的每一行前面都有一个Tab键的额长度，即4个空格
for(int i = 0 ; i < 5; i++){
    println("asdasdasdasd")
}

看下效果：我这里就随意的写一段代码为演示

注意看下面的每一行前面都有一个Tab键的额长度，即4个空格
for(int i = 0 ; i < 5; i++){
    println("asdasdasdasd")
}

2.7.3、纯文本

纯文本的使用：在一段文本的两端分别加上3个英文的（`）符号，例：\
1
2
3
4
其实在写文章的时候，几乎用不到纯文本，因为在用代码块几乎上可以代替他了。不过还是有特例，就比如说上面的那个例子就用到了纯文本。

举例说明：

for(int i = 0 ; i < 5; i++){
    println("asdasdasdasd")
}
1
2

看下效果：

for(int i = 0 ; i < 5; i++){
println(“asdasdasdasd”)
}
`

2.7.4、换行符

换行符的使用这里提供三种方式：
使用Html中的<br/>标签（不推荐），因为在某一些工具或在线平台中达不到效果
段落与段落之间使用一个空行（推荐）
在第一段文本结束后使用两个空格，在换行写第二段文本。（推荐）

1. 使用<br/>

举例说明：

第一段文本<br/>
第二段文本

看下效果：

第一段文本

第二段文本

2. 使用空行

举例说明：

第一段文本

第二段文本

看下效果：

第一段文本

第二段文本

3. 使用两个空格

举例说明：

第一段文本(这里跟了两个空格)   
第二段文本

看下效果：

第一段文本
第二段文本

2.8、分割线

分割线的使用：在段落与段落之间加上3个中划线(-)。

举例说明：

---

看下效果

最后

我相信在你详细看完这篇文章后，用以上的语法去写文章或者文档完全足够你用了。不过大家还是要踊跃的尝试下，应为上面的例子只是单方面的讲解这一个知识点。而写文章或者文档的时候，几乎上都是混用的。比方说，列表嵌套列表、应用嵌套列表，列表里面文本加粗等等…。孰能生巧，当你写一遍文章下来，我相信你已经掌握了Markdown的语法了。我相信你也会深深的爱上它的…

这一篇文章主要让您了解Markdown以及掌握其语法规则。而关于Markdown的编辑器我会在下一篇文章中为大家详细的介绍。

目录

一、Markdown简介

1.1、认识Markdown

1.2、使用Markdown的好处

二、Markdown语法规则

2.1、标题

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2.2、列表

2.2.1、有序列表

2.2.2、无序列表

2.2.3、有序列表和无序列表之间的混用情况

2.3、引用

2.3.1、基本使用

2.3.2、嵌套引用

2.4、文字的样式

2.4.1、加粗

2.4.2、斜体

2.4.3、删除线

2.4.4、下划线

2.4.4.1、解决方案：

2.4.4.2、使用行内Html代码解决的两种方式

2.4.5、数学公式中的表达方法（很少用到）

2.5、链接与图片

2.5.1、链接

2.5.2、图片

2.6、表格

2.6.1、基本使用

2.6.2、表格的对齐方式

2.7、关键字、代码块、多行文本、换行

2.7.1、关键字

2.7.2、代码块

2.7.3、纯文本

2.7.4、换行符

2.8、分割线

最后

2.4.4.2、使用行内`Html`代码解决的两种方式