Markdown语法介绍

前言

最近准备开始写博客，整理自己学习的技术知识。但手动调整博客的文本格式实在太不美观和geek，因而选择Markdown排版博客内容。Markdown是一种轻量级标记语言，且兼容HTML。可通过标记符号设置文本格式，让作者专注于写作内容，当前的主流博客网站和GitHub版块多采用Markdown。

Markdown将格式对象主要分为区块元素和区段元素两部分。区块元素主要包括段落，换行，标题，区块引用，列表和分割线；区段元素包括强调，链接，图片和代码块。

区块元素

段落和换行

Markdown中段落是由一个或多个连续的本文组成，段落前后应该有1个以上的空行，单独的换行符不会实现段落换行。如果不想插入空行进行换行，可以在换行符前插入2个以上的空格来实现段落换行。例如：

第一段

第二段

或

第一段(两空格)
第二段

标题

在标题文本前使用“#”，并用空格分割可以创建一级标题。如果需要创建多级标题，可使用不同数量的“#”，最多可创建6级标题。如下所示：

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

区块引用

Markdown标记区块引用时，在每行的开头添加符号">"或在每段的第一行开头添加">"，如下所示：

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

或

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
>Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

效果如下：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

另外区块引用允许多级嵌套，只需根据层次添加不同数量的">"。例如：

> 这是第一级引用。
>
> > 这是第二级引用。
>
> 现在回到第一级引用。

效果如下

这是第一级引用。

这是第二级引用。

现在回到第一级引用。

列表

Markdown支持有序列表和无序列表。

无序列表使用“*”，"+"和"-"作为记号，通常放在最左侧，记号与文本间用空格分割。

* 列表1
* 列表2
* 列表3

效果如下

• 列表1
• 列表2
• 列表3

有序列表使用数字加英文句号作为记号，记号与文本间用空格分割，且有序列表的序号与记号中的数字无关。例如以下两组列表，生成的列表序号相同。

1. 列表1
2. 列表2
3. 列表3

1. 列表1
1. 列表2
1. 列表3

效果如下

1. 列表1
2. 列表2
3. 列表3

如果需要在列表中加入区块引用或代码块，则整个区块或代码块需整体缩进4个空格或一个制表符，例如：

* 列表1
        > 引用内容

效果如下所示

• 列表1

  引用内容

分割线

在单独的一行中使用三个以上的星号"*"，减号“-”或底线"_"来创建分割线，且行内不能再有其他内容。

___
***
---

效果如下

---

区段元素

强调

强调包括斜体和加粗两种方式。

斜体使用一对“*”包裹需要强调的文字，例如:

*斜体*

其效果为：斜体

加粗使用一对“**”包裹需要强调的文字，例如：

*加粗*

其效果为：加粗

代码块

标记代码块的方式有两种。一种是通过缩进4个空格或1个制表符进行标记；更常用的方法是使用反引号将代码块包裹起来，避免无休止的缩进。该方法可指定语言标识，对标记的代码块启用语法着色。例如：

```python
import sys
img_list_in = open(sys.argv[1])
```

效果如下：

import sys
img_list_in = open(sys.argv[1])

链接

Markdown支持两种链接的表示方式：内联式和引用式。

内联式的表示形式为 [text] (URL)。其中，[]中的内容是链接文字，()中的内容是链接地址。例如：

This is [GitHub] (https://www.github.com) link.

效果如下
This is GitHub link.

引用式的表示方式为

[text] [id]

[id]: URL

例如：

This is [GitHub] [github] link.

[github]: https://www.github.com

效果如下：
This is GitHub link.

插入图片

Markdown使用与链接相似的语法来插入图片，也可分为内联式和引用式。

内联式插入图片的语法为：

![text] (URL)

引用式插入图片的语法为：

![text] [id]

[id]: URL

例如：


或

![CR7] [player]

[player]: http://bestsportsshots.com/wp-content/uploads/2018/01/cr7-power.jpg

效果如下

CR7

需要注意的是，Markdown无法指定插入图片的宽高。如果需要，可以使用 标签。