Markdown语法入门

更新时间: 2017-03-29 17:23
当前版本: v0.0.2

1 标题

标题是每篇文章都有，也是最常用的格式。在Markdown语法中，标题使用井号（#）开头，独占一行，后面添加一个空格分隔，之后的内容即为标题文本。

# 一级标题
## 二级标题
### 三级标题
...

以此类推，总共支持6级标题。

段落和换行

一个Markdown段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行。

2 列表

在Markdown中，列表的显示只需要在文字前加上减号（-）或者星号（*）即可变为无序列表；如果在文字之前直接加上(数字+点)，例如1.、2.、3.等。

注意：符号和列表文字之间也需要加上一个空格分割。

3 引用

如果你需要引用一小段别处的句子，那么可以使用引用格式。在Markdown中，只需要在段落的第一行最前面加上大于号(>)，后面跟上你需要引用的文本即可，格式如下：

> 日出江花红胜火，春来江水绿如蓝。

显示效果如下：

日出江花红胜火，春来江水绿如蓝。

问题：如何在引用的内容中使用换行？

方法：在上一行文本的末尾添加两个空格再回车。

嵌套引用

引用是可以嵌套的，只需要根据层次加上不同数量的大于号(>)，例如：

> 这是第一层引用开头
> >这是第二层引用开头  
> 
> 这是第一层引用结尾

运行效果如下：

这是第一层引用开头

这是第二层引用开头

这是第一层引用结尾

4 图片与链接

插入图片和插入链接的语法格式非常相似，区别在于插入图片时开头多了一个感叹号(!)。

插入图片

![](image_url)

注意：插入图片地址时需要图床，也就是需要一个存放图片的位置，并生成对应的URL。

插入链接

[link_display_name](link_url)

5 粗体和斜体

在Markdown中，可以使用文本前后各两个星号（*）或者下划线（_）来粗体表示星号中间的文字；使用文本前后各一个星号来斜体表示星号中间的文字。格式如下：

** 这是粗体 **
* 这是斜体 *

6 表格

在Markdown语法中，表示表格十分麻烦，示例如下：

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

其中，第一行用于设置表格的头部，列与列之间使用单竖线（|）分隔。第二行用于设置每一列的对齐方式，默认为左对齐，如果短横线两边各有一个冒号（:）就是居中对齐；否则，哪边有，就跟哪边对齐。效果如下：

Tables	Are	Cool
col 3 is	right-aligned	$1600
col 2 is	centered	$12
zebra stripes	are neat	$1

7 代码框

对于程序员而言，经常需要在文章中引用一段代码，这个时候就需要使用到代码框。在Markdown中，只需要使用前后各3个反引号（```）把代码片段包裹在中间即可。如果需要引用的代码只有一行，那么可以使用前后各1个反引号(`)把代码包裹起来。

```
import math
print math.PI
```

以上代码的运行效果如下：

import math
print math.PI

注意：可以使用TAB键进行缩进。

8 分割线

在Markdown中，三个连续的星号(*)可以生成一根分割线。运行效果如下：

9 反斜杠

Markdown可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果，你可以在星号的前面加上反斜杠：

\*不使用斜体，仅仅在两端使用星号强调*

*不使用斜体，仅仅在两端使用星号强调*

参考资料

最后编辑于：2017.12.06 06:29:51