魏麻衣

2019-04-17 17:27 已编辑中国人民大学运维工程师

关注

Markdown 语法说明

1. Markdown是什么？

Markdown是一种轻量级标记语言，它以纯文本形式(易读、易写、易更改)编写文档，并最终以HTML格式发布。
Markdown也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。

2. 谁创造了它？

它由Aaron Swartz和John Gruber共同设计，Aaron Swartz于2013年***去世。维基百科对他的介绍是：软件工程师、作家、***组织者、互联网活动家、维基百科人。

简单介绍一下这位天才，短暂而开挂的一生：

14岁参与RSS 1.0规格标准的制订。
2004年入读斯坦福，之后退学。
2005年创建Infogami，之后与Reddit合并成为其合伙人。
2010年创立求进会（Demand Progress），积极参与禁止网络盗版法案（SOPA）活动，最终该提案被撤回。
2011年7月19日，因被控从MIT和JSTOR下载480万篇学术论文并以免费形式上传于网络被捕。
2013年1月***身亡。

3. 为什么要使用它？

它是易读（看起来舒服）、易写（语法简单）、易更改纯文本。处处体现着极简***的影子。
兼容HTML，可以转换为HTML格式发布。
跨平台使用。
越来越多的网站支持Markdown。
更方便清晰地组织你的电子邮件。（Markdown-here, Airmail）
摆脱Word

4. 怎么使用？

Markdown的语法绝对简单到让你爱不释手。

Markdown语法主要分为如下几大部分：标题，强调，代码，列表，段落，区块引用，分割线，链接，图片，数学公式，反斜杠 \。

4.1 标题

这是最为常用的格式，在平时常用的的文本编辑器中大多是这样实现的：输入文本、选中文本、设置标题格式。

而在 Markdown 中，你只需要在文本前面加上 # 即可，同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题，总共六级，只需要增加 # 即可，标题字号相应降低。例如：

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

注：# 和「一级标题」之间建议保留一个字符的空格，这是最标准的 Markdown 写法。

一级标题

二级标题

三级标题

4.2 强调

在强调内容两侧分别加上*或者_，如：

*斜体*，_斜体_
**粗体**，__粗体__

效果：

斜体，斜体
粗体，粗体

4.3 列表

列表格式也很常用，在 Markdown 中，你只需要在文字前面加上 - 就可以了，例如：

- 文本1
- 文本2
- 文本3

如果你希望有序列表，
也可以在文字前面加上 1. 2. 3. 就可以了，例如：

1. 文本1
2. 文本2
3. 文本3

注：-、1.和文本之间要保留一个字符的空格。

4.4 代码

单行代码：代码之间分别用一个反引号包起来

单行代码

效果: create database hero;

代码区块：代码之间分别用三个反引号包起来，且两边的反引号单独占一行

代码区块

效果:

void main()
{
    printf("Hello, Markdown.");
}

4.5 段落

段落的前后要有空行，所谓的空行是指没有文字内容。

4.6 分割线

分割线最常使用就是三个或以上*，还可以使用-和_。

4.7 链接

链接可以由两种形式生成：行内式和参考式。
行内式：

[Markdown使用说明](https://www.nowcoder.com/discuss/179680 "Markdown")

效果：

Markdown使用说明。

参考式：

[Markdown使用说明1][1]
[Markdown使用说明2][2]
[1]:https://www.nowcoder.com/discuss/179680 "Markdown"
[2]:https://www.nowcoder.com/discuss/179680 "Markdown"

效果：

Markdown使用说明1
Markdown使用说明2

注意：上述的[1]: https://www.nowcoder.com/discuss/179680 "Markdown"不出现在区块中。

4.8 图片

添加图片的形式和链接相似，只需在链接的基础上前方加一个！。

4.9 数学公式

我们的Markdown语法还支持LaTeX数学公式，这属于相当高阶的应用

公式源码:

$O(\displaystyle{\frac{n^2}{S}}+m \times S)$

效果：

$O(\displaystyle{\frac{n^2}{S}}+m \times S)$

公式源码:

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$

效果：

$\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\ \end{vmatrix}$

4.10 表格

还可以制作表格，例如：

dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz

显示效果：

dog	bird	cat
foo	foo	foo
bar	bar	bar
baz	baz	baz

用|表示表格纵向边界，表头和表内容用-隔开，并可用:进行对齐设置，两边都有:则表示居中，若不加:则默认左对齐。
比如：

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

显示效果：