、
 
等标签，必须在前后加上空行，以便于内容区分。而且这些元素的开始与结尾标签，不可以用 
tab 
或是空白来缩进。Markdown 
会自动识别这区块元素，避免在区块标签前后加上没有必要的 
 
标签。 
例如，在 
Markdown 
文件里加上一段 
HTML 
表格： 
This is a regular paragraph. 

4

This is another regular paragraph.

请注意，Markdown

语法在

HTML

区块标签中将不会被进行处理。例如，你无法在

HTML

区块内使用

Markdown

形式的强调。

7

引用

使用

>

符号表示引用。例如：

>

这是一段引用文本。呈现的输出如下所示：

这是一段引用文本。

HTML

如下所示：

这是一段引用文本。

块引用也可以嵌套：

>

这是一段引用文本。

>>

这是

l

另一段引用文本。

呈现的输出如下所示：

这是一段引用文本。

这是

l

另一段引用文本。

8

列表

无序列表使用

*、+

或-符号作为列表项标记，有序列表使用数字加.

作为列表项标记。

8.1

无序列表

无序列表使用

*、+

或-符号作为列表项标记：

* valid bullet

- valid bullet

+ valid bullet

呈现的输出如下所示：

• valid bullet

• valid bullet

• valid bullet

列表可以嵌套，例如：

* Markdown is platform independent.

* Markdown is portable.

* Markdown is future proof.

* Markdown can be used for everything.

* People use it create websites.

* People use it create documents.

5

* People use it create notes.

* People use it create books.

* People use it create email messages.

* Markdown is everywhere.

呈现的输出如下所示：

• Markdown is platform independent.

• Markdown is portable.

• Markdown is future proof.

• Markdown can be used for everything.

– People use it create websites.

– People use it create documents.

– People use it create notes.

– People use it create books.

– People use it create email messages.

• Markdown is everywhere.

HTML

如下所示：

• Markdown is platform independent.
• Markdown is portable.
• Markdown is future proof.
• Markdown can be used for everything.

• People use it create websites.
• People use it create documents.
• People use it create notes.
• People use it create books.
• People use it create email messages.

• Markdown is everywhere.

8.2

有序列表

有序列表使用数字加.

作为列表项标记。例如：

1. Markdown is platform independent.

2. Markdown is portable.

3. Markdown is future proof.

4. Markdown can be used for everything.

5. Markdown is everywhere.

呈现的输出如下所示：

1. Markdown is platform independent.

2. Markdown is portable.

3. Markdown is future proof.

4. Markdown can be used for everything.

5. Markdown is everywhere.

HTML

如下所示：

1. Markdown is platform independent.

6

2. Markdown is portable.
3. Markdown is future proof.
4. Markdown can be used for everything.
5. Markdown is everywhere.

8.3

任务列表

任务列表允许您创建带有复选框的项目列表。若要创建任务列表，请在任务列表项之前添加短划线-和带空格的方括号

[ ]。要选中复选框，请在方括号之间添加一个

x。

- [x] Write a blog

- [ ] Update the website

- [ ] Send the email

呈现的输出如下所示：

⊠ Write a blog

□ Update the website

□ Send the email

9

代码

使用三个反引号包围一段代码来表示代码块，使用一个反引号包围一段代码来表示行内代码。

9.1

代码块

使用三个反引号包围一段代码来表示代码块，例如：

这是一个行内代码：`('Hello, World!')`

9.2

行内代码

使用一个反引号包围一段代码来表示行内代码，例如：

('Hello, World!')

('Hello, Markdown!')

9.3

缩进代码

或者将几行代码缩进至少四个空格，如下所示：

// Some comments

line 1 of code

line 2 of code

line 3 of code

呈现的输出如下所示：

// Some comments line 1 of code line 2 of code line 3 of code

9.4

语法高亮显示

语法高亮显示只需在第一个代码

“fence”

之后直接添加要使用的语言的文件扩展名，语法高亮显示将自动应用于渲染的

HTML。

例如，要将语法高亮显示应用于

JavaScript

代码：

7

nfig({ assemble: {

options: {

assets: 'docs/assets',

data: 'src/data/*.{json,yml}',

helpers: 'src/',

partials: ['src/partials/*.{hbs,md}']

},

pages:

{ options: {

layout: ''

},

files: {

'./': ['src/templates/pages/']

}

}

}

};

10

表格

(Table)

使用

|

符号分隔单元格，使用-符号分隔表头和其他行。例如：

呈现的输出如下所示：

|

标题

1

标题

2

标题

3

标题

4

标题

5

标题

6

标题

7

标题

8

标题

9

标题

10

data1

data1

data1

data2

data2

data2

data3

data3

data3

data4

data4

data4

data5

data5

data5

data6

data6

data6

data7

data7

data7

data8

data8

data8

data9

data9

data9

data10

data10

data10

HTML

代码如下：

8

11

链接

链接使用方括号包围链接文本，紧跟圆括号包围链接地址。

[链接文本](链接地址)

命名锚点

使用命名锚点可以跳转到同一页面上的指定锚点。例如，以下每一章：

## Table of Contents

* [Chapter 1](#chapter-1)

* [Chapter 2](#chapter-2)

* [Chapter 3](#chapter-3)

9

将跳转到以下部分：

## Table of Contents

* [Chapter 1](#chapter-1)

* [Chapter 2](#chapter-2)

* [Chapter 3](#chapter-3)