Markdown 是一种轻量级标记语言。
它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML(或者HTML)文档。
这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
掌握Markdown语法的基本语法，只需要十点就够了。

Q: 有哪些网站可以用来写Markdown呢？

A: Github、简书都支持Markdown，Github中可以一边写Markdown一边预览。

Q: 有哪些Markdown编辑器呢？

A: 近似全能的新兴编辑器Visual Studio Code、MarkdownPad都可以用来写Markdown，你可以用他们来进行练习。

在Gist中，用Github账号登录以后即可建立一个Gist（可以理解为文章），在里面编辑Markdown文档可以直接点击Preview查看效果。

在Visual Studio Code中新建一个Markdown文档（即新建文档 -> 另存为 文件名.md），在编辑时点击右上角预览按钮可以实时预览效果。

目录

• 一、段落和换行
• 二、标题
• 三、列表
• 四、链接
• 五、图片
• 六、粗体和斜体
• 七、代码
• 八、引用
• 九、反斜杠
• 十、分割线
• Tips

一、段落和换行

在Markdown里，一个换行不会另起一行，只有两个（及以上）的换行会另起一行。这是为了保证书写格式的整齐。

每一行的行首不能有空格和缩进。

二、标题

用 # 来标记标题，# 越多，标题级别越小。# 后面要有一个空格，表明这个#是标题的意思。

1
2
3
4
5

# Head 1
## Head 2
### Head 3
#### Head 4
##### Head 5

Head 1

Head 2

Head 3

Head 4

Head 5

三、列表

用 * 来标记无序列表的项目，* 后面要有空格，缩进可以调整项目级别。

1
2
3
4
5

* Item 1
* Item 2
* Item 3
	* Item 3.1
	* Item 3.2

• Item 1
• Item 2
• Item 3
  • Item 3.1
  • Item 3.2

用 1.、2.、3.（数字后面加一个点）标记有序列表的项目，标号后面要有空格。

1
2
3
4

1. Item 1
2. Item 2
3. Item 3
4. Item 4

1. Item 1
2. Item 2
3. Item 3
4. Item 4

四、链接

用方括号和圆括号表示链接。方括号括起 网址的标题或描述， 圆括号括起 网址。
就像这样：

1

[弹幕派](www.danmakupie.com)

弹幕派

五、图片

图片和链接比较像，只不过图片要在前面加一个感叹号（!），方括号括起 图片的标题或描述，圆括号括起图片地址。

1

![弹幕派Logo](http://7xr64j.com1.z0.glb.clouddn.com/blog/howtowritemarkdown/danmakupie-logo.png)

六、粗体和斜体

用**和*分别标记粗体和斜体。

1

**粗体**  *斜体*

粗体 斜体

七、代码

代码分为两种，一种是大段文字里掺杂一些代码，用`（键盘左上角的反引号）标记。

1

在写C语言之前，要引入`#include <stdio.h>`才能正常编译。

在写C语言之前，要引入#include <stdio.h>才能正常编译。

另外一种是大块代码，用三个`（反引号）标记。

```

#include <stdio.h>

int main(void){
return 0;
}
```

1
2
3
4
5

#include <stdio.h>
 
int main(void){
    return 0;
}

我们还可以将代码行都缩进一个Tab，从而将这些行标记为代码（这也就是为什么不要在普通文字前面缩进）。

1
2
3
4
5

[Tab]   #include <stdio.h>
[Tab]	
[Tab]	int main(void){
[Tab]	    return 0;
[Tab]	}

1
2
3
4
5

#include <stdio.h>
 
int main(void){
    return 0;
}

八、引用

有的时候我们需要标明一段话是引用自其他文章的，我们用>标记。

1
2
3
4
5
6

> 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.
> 
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

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.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

九、反斜杠（转义字符）

上面可以看到，有很多字符都用来当标记符了。那么如果我们需要输入这些字符怎么办呢？
答案就是反斜杠，用反斜杠来转义这些字符。

1

\*literal asterisks\*

*literal asterisks*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

1
2
3
4
5
6
7
8
9
10
11
12

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

十、分割线

在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。

1
2
3
4
5
6
7

* * *

***

*****

- - -

Tips:

1. 如果想要添加一个发送电子邮件的链接该怎么办？

1

[联系我们](mailto:danmakupie@outlook.com)

联系我们

1

[联系我们](mailto:danmakupie@outlook.com?subject=弹幕派意见反馈)

联系我们

2. 链接可以跳转到本页面的另一个地方吗？

在Github里是支持跳转到页面里的另一个标题的：

1

[八、引用](#八、引用)

八、引用

这样就可以跳转到“八、引用”这个标题了。这可以用来做目录。

所有用#标记的标题都可以。GitHub对中文的支持不太好。

3. 参考式链接

一些链接可能要在文档里重复多次，每次都要写一遍链接太费事了。因此就有参考式链接。
参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记：

1

This is [an example][1] reference-style link.

接着，在文件的任意处，你可以把这个标记的链接内容定义出来：

1

[1]: http://www.danmakupie.com "弹幕派"

This is an example reference-style link.

4. 引用可以嵌套引用吗？

可以，通过多个>可以不断嵌套：

1
2
3
4
5

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

引用里还可以有其他标记：

1
2
3
4
5
6
7
8

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input | $markdown_script");

这是一个标题。

1. 这是第一行列表项。
2. 这是第二行列表项。

给出一些例子代码：

return shell_exec("echo $input | $markdown_script");

5. 如何输入上标和下标？

用<sub>和</sub>包括下标文字：

1

H<sub>2</sub>O

H₂O

用<sup>和</sup>包括上标文字：

1

X<sup>2</sup>+2x+1 = 0

X²+2x+1 = 0

6. 代码块如何进行语法高亮？

在```之后加上语言的标记，例如：

``` c 可以标记C语言。

具体各语言高亮支持请查看highlight.js - CSS classes reference

参考资料

http://wowubuntu.com/markdown/

延伸阅读

Learning-Markdown (Markdown 入门参考)

这里有讲怎么用Markdown画表格（虽然我从来没画出来过）。