Markdown

Markdown 是什么？

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML（或其他格式）。Markdown 语法简洁明了、学习容易，而且功能比纯文本更强，因此有很多人用它来写博客。世界上最流行的博客平台 GitHub 和许多其他平台都支持 Markdown。

Markdown 的基本语法

标题

在 Markdown 中，可以使用 # 符号来表示标题。例如：

1
# 一级标题
2
## 二级标题
3
### 三级标题

段落

在 Markdown 中，段落是由一个或多个连续的文本行组成，不需要任何特殊的标记。例如：

1
这是一个段落。
2
这是另一个段落。

强调

在 Markdown 中，可以使用 * 或 _ 符号来表示强调。例如：

1
*斜体文本*
2
_斜体文本_
3
**粗体文本**
4
__粗体文本__

列表

在 Markdown 中，可以使用 -、+ 或 * 符号来表示无序列表，使用数字和点号来表示有序列表。例如：

1
- 无序列表项 1
2
- 无序列表项 2
3
- 无序列表项 3
4

5
1. 有序列表项 1
6
2. 有序列表项 2
7
3. 有序列表项 3

链接

在 Markdown 中，可以使用 [链接文本](链接地址) 的语法来插入链接。例如：

1
[百度](https://www.baidu.com)

图片

在 Markdown 中，可以使用 ![图片描述](图片地址) 的语法来插入图片。例如：

1
![图片描述](https://www.example.com/image.jpg)

代码块

在 Markdown 中，可以使用反引号（`）来表示代码块。例如：

1
`这是一个代码块`

引用

在 Markdown 中，可以使用 > 符号来表示引用。例如：

1
> 这是一个引用

表格

在 Markdown 中，可以使用以下语法来表示表格：

1
| 标题1 | 标题2 | 标题3 |
2
|-------|-------|-------|
3
| 内容1 | 内容2 | 内容3 |
4
| 内容4 | 内容5 | 内容6 |

Markdown 的扩展语法

代码块

在 Markdown 中，可以使用三个反引号（```）来表示代码块。例如：

1
```python
2
def hello_world():
3
    print("Hello, world!")

1
### 表格
2

3
在 Markdown 中，可以使用以下语法来表示表格：
4

5

6
# An h1 header
7

8
Paragraphs are separated by a blank line.
9

10
2nd paragraph. _Italic_, **bold**, and `monospace`. Itemized lists
11
look like:
12

13
- this one
14
- that one
15
- the other one
16

17
Note that --- not considering the asterisk --- the actual text
18
content starts at 4-columns in.
19

20
> Block quotes are
21
> written like so.
22
>
23
> They can span multiple paragraphs,
24
> if you like.
25

26
Use 3 dashes for an em-dash. Use 2 dashes for ranges (ex., "it's all
27
in chapters 12--14"). Three dots ... will be converted to an ellipsis.
28
Unicode is supported. ☺
29

30
## An h2 header
31

32
Here's a numbered list:
33

34
1. first item
35
2. second item
36
3. third item
37

38
Note again how the actual text starts at 4 columns in (4 characters
39
from the left side). Here's a code sample:
40

41
    # Let me re-iterate ...
42
    for i in 1 .. 10 { do-something(i) }
43

44
As you probably guessed, indented 4 spaces. By the way, instead of
45
indenting the block, you can use delimited blocks, if you like:

define foobar() { print “Welcome to flavor country!”; }

1
(which makes copying & pasting easier). You can optionally mark the
2
delimited block for Pandoc to syntax highlight it:
3

4
```python
5
import time
6
# Quick, count to ten!
7
for i in range(10):
8
    # (but not *too* quick)
9
    time.sleep(0.5)
10
    print i

An h3 header

Now a nested list:

1. First, get these ingredients:

   • carrots
   • celery
   • lentils

2. Boil some water.

3. Dump everything in the pot and follow this algorithm:

   1
   find wooden spoon
   2
   uncover pot
   3
   stir
   4
   cover pot
   5
   balance wooden spoon precariously on pot handle
   6
   wait 10 minutes
   7
   goto first step (or shut off burner when done)

   Do not bump wooden spoon or it will fall.

Notice again how text always lines up on 4-space indents (including that last line which continues item 3 above).

Here’s a link to a website, to a local doc, and to a section heading in the current doc. Here’s a footnote ¹.

Tables can look like this:

size material color

9 leather brown 10 hemp canvas natural 11 glass transparent

Table: Shoes, their sizes, and what they’re made of

(The above is the caption for the table.) Pandoc also supports multi-line tables:

keyword text

red Sunsets, apples, and other red or reddish things.

green Leaves, grass, frogs and other things it’s not easy being.

A horizontal rule follows.

Here’s a definition list:

apples : Good for making applesauce. oranges : Citrus! tomatoes : There’s no “e” in tomatoe.

Again, text is indented 4 spaces. (Put a blank line between each term/definition pair to spread things out more.)

Here’s a “line block”:

| Line one | Line too | Line tree

and images can be specified like so:

Inline math equations go in like so: . Display math should get its own line and be put in in double-dollarsigns:

And note that you can backslash-escape any punctuation characters which you wish to be displayed literally, ex.: `foo`, *bar*, etc.