【精选】Markdown 语法汇总

博客园也能Markdown？美滋滋，Markdown真的是好用QAQ。
本文档按照Markdown各类经常使用语法类别，以文字描述+演示的方式来展示markdown语法的使用。Markdown 的目标是实现[易读易写]，成为一种适用于网络的书写语言。HTML 是一种发布的格式，Markdown 是一种书写的格式，Markdown 的格式语法只涵盖纯文本能够涵盖的范围，Markdown 语法兼容HTML语法。

段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成，它的先后要有一个以上的空行。普通的Markdown 段落不能够用空格或制表符来缩进。

空行：一行以内只包含回车换行、空格、制表符。

标题

Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。

(1)类 Setext 形式

类 Setext 形式语法是使用用标题下底线的形式，包括 = （一级标题）和 - （二级标题），任何数量的 = 和 - 均可以有效果。 例如：

一级标题下加=

二级标题下加-

(2)类 atx 形式

类 Atx 形式则是在行首插入 1 到 6 个 # ，#和标题文字之间使用一个或多个空格，对应到标题 1 到 6 级， 例如：

这是 H1

这是 H2

这是 H3

强调

Markdown 使用星号（*）和下滑线（_）做为标记强调字词的符号，例如：

斜体
加粗

可是若是你的*和 _ 两边都有空白的话，它们就只会被当成普通的符号。若是要在文字先后直接插入普通的星号或下划线，你能够用反斜线： 例如： 使用反斜线开头的被当作是普通的字符*

区块引用

Markdown 标记区块引用的方法是在行的最前面加 > ，也能够只在整个段落的第一行最前面加上 >，区块引用内部能够嵌套，只要根据层次加上不一样数量的 >便可，引用的区块内也可使用其余的 Markdown 语法，包括标题、列表、代码区块等。 例如:

Markdown 标记区块引用的方法是在行的最前面加> 也能够只在整个段落的第一行最前面加上 >

区块引用内部能够嵌套，只要根据层次加上不一样数量的 >便可.我是内部嵌套区块，我可使用其余Markdown 语法哦

我是引用区块内使用标题3语法

在引用区块内能够加入代码块 import java.net.URL; import java.util.Arrays; import java.util.Date; import java.util.Set;

列表

Markdown 支持有序列表和无序列表，无序列表使用星号、加号或是减号做为列表标记，有序列表则使用数字接着一个英文句点。两种列表方式格式都是：列表标记+空格+列表项，即列表项目标记一般是放在最左边，也能够缩进最多 3 个空格，项目标记后面则必定要接着至少一个空格或制表符。

(1)无序列表

星号、加号或是减号三种列表方式效果等同。 例如：

*Red

*Green

*Blue

星号列表

*   Red
*   Green
*   Blue

加号列表

*Red
*Green
*Blue

减号列表

*Red
*Green
*Blue

(2)有序列表

有序列表则使用数字接着一个英文句点. 例如：

1.Red

2.Green

3.Blue

代码块
同各类程序语言相关的写做或是标签语言原始码一般会有已经排版好的代码块，一般这些代码块咱们并不但愿它以通常段落的方式去排版，而是照原来的样子显示。 Markdown创建代码块的方法：只要在行最前面简单地缩进 4 个空格或是 1 个制表符就能够，一个代码区块会一直持续到没有缩进的那一行。

这是一个代码区块。
只要简单地缩进 4 个空格或是 1 个制表符就能够
一个代码区块会一直持续到没有缩进的那一行

小段代码

须要引用代码时，若是引用的语句只有一段，不分行，能够用 ` 将语句包起来。 若是引用的语句为多行，能够将```置于这段代码的首行和末行。

​```cpp
#include<iostream>
​```

分隔线

能够在一行中用三个以上的星号、减号、底线来创建一个分隔线，行内不能有其余内容。也能够在星号或是减号中间插入空格。下面每种写法均可以创建分隔线：

* * *

***

*****

- - -

---------------------------------------

---

---

---

---

---

连接

在方块括号后面紧接着圆括号并插入网址连接便可，若是你还想要加上连接的 title 文字，只要在网址后面，用双引号把 title 文字包起来便可，例如： 这是 行内式连接标题 内联方式.

[行内式连接标题](https://www.cnblogs.com/gongdakai/)

图片

Markdown 使用一种和连接很类似的语法来标记图片。

行内式的图片语法以下：   详细叙述以下： 一个惊叹号 ! 接着一个方括号，里面放上图片的替代文字，接着一个普通括号，里面放上图片的网址，最后还能够用引号包住并加上 选择性的 'title' 文字。

自动连接

Markdown 支持以比较简短的自动连接形式来处理网址和电子邮件信箱，只要是用方括号包起来， Markdown 就会自动把它转成连接。通常网址的连接文字就和连接地址同样。

反斜杠

Markdown 能够利用反斜杠来插入一些在语法中有其它意义的符号，例如：若是你想要用星号加在文字旁边的方式来作出强调效果，你能够在星号的前面加上反斜杠： Markdown 支持如下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号