markdown渲染手册

换行

直接在要换行的两个段落之间插入回车即可。

例如：

这是第一行文字
这是第二行文字

显示的效果如下：

这是第一行文字

这是第二行文字

标题

Markdown 的标题是在行首插入 1 到 6 个 #，# 和标题文字之间使用一个或多个空格，对应到标题 1 到 6 级。

例如：

# 这是 H1
## 这是 H2
### 这是 H3
#### 这是 H4
##### 这是 H5
###### 这是 H6
这是雪豹

显示的效果如下：

这是 H1

这是 H2

这是 H3

这是 H4

这是 H5

这是 H6

这是雪豹

强调

被 * 或 _ 包围的字词会被转成斜体

用两个 * 或 _ 包起来的话，则会被转成粗体

例如

*单星号斜体*

_单下划线斜体_

**双星号加粗**

__双下划线加粗__

~~删除线~~

显示的效果如下：

单星号斜体

单下划线斜体

双星号加粗

双下划线加粗

~~删除线~~

如果要在文字中插入普通的保留字符，可以用反斜线（\）

例如：


\# 普通井号

\* 普通星号 \*

\_ 普通下划线 \_

显示的效果如下：

# 普通井号

* 普通星号 *

_ 普通下划线 _

代码块

将 ``` 或 ` 或四个空格置于这段代码的首行和末行，独立成一行。

例如：

```
这是一段代码
```

渲染效果：

这是一段代码

区块引用

在要标记引用行的最前面加 > ，也可以只在整个段落的第一行最前面加上 >

区块引用内部可以嵌套，只要根据层次加上不同数量的 > 即可，引用的区块内也可以使用其他的 Markdown 语法。

例如：

>这是第一层引用

>>这是第二层引用

>>**引用的区块内也可以使用其他的 Markdown 语法**

显示的效果如下：

这是第一层引用

这是第二层引用

引用的区块内也可以使用其他的 Markdown 语法

列表

Markdown 支持有序列表和无序列表，无序列表使用星号、加号或是减号作为列表标记，有序列表则使用数字接着一个英文句点。

两种列表方式格式都是：列表标记 + 空格 + 列表项，即列表项目标记通常是放在最左边，也可以缩进最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符。

1 无序列表

星号、加号或是减号三种列表方式效果等同。

例如：


*   内容1

*   内容2

*   内容3


+   内容1

+   内容2

+   内容3


-   内容1

-   内容2

-   内容3

显示的效果均如下：

内容1
内容2
内容3

2 有序列表

有序列表则使用数字接着一个英文句点。

例如：


1.   内容1

2.   内容2

3.   内容3

显示的效果如下：

内容1
内容2
内容3

链接

在方块括号后面紧接着圆括号并插入网址链接即可

语法如：

[链接名字](链接的网址)

如果还想要加上链接的title文字，只要在网址后面，用双引号把title文字包起来即可。

例如：

[返回主页](http://qingxie.xyz)

显示的效果如下：

返回主页

图片

和链接很相似，在互联网上发表含有图片的内容时，需要先将该图片上传至图床，再引用图片。

语法如：

![图片加载失败时的文字](图片路径)

例如：

![logo](http://qingxie.xyz/favicon.ico)

显示的效果如下：

加载失败则会显示：

自动链接

用< >把要转成链接的网址包起来，markdown就会自动将它转为网址。

例如：

<http://qingxie.xyz>

显示的效果如下：

http://qingxie.xyz

分割线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他内容。也可以在星号或是减号中间插入空格，数量不限。

下面每种写法都可以建立分隔线：

* * *

***

*****

- - -

---

---------------------------------------

显示的效果均如下：

插入视频

可以用:video(url)的格式插入视频，同图片一样，在互联网上发表含有视频的内容时，需要先将该视频上传至一些网盘，再引用视频。前后均可以有文字，中间不可有其他内容。注：原版markdown不支持，仅在本站可用该语法。

例如：

:video(http://qingxie.xyz/never_gonna_give_you_up.mp4)

显示的效果如下：

插入音频

可以用:music(url)的格式插入视频，同图片一样，在互联网上发表含有音频的内容时，需要先将该音频上传至一些网盘，再引用音频。注：原版markdown不支持，仅在本站可用该语法。

例如：

:music(http://qingxie.xyz/M500001w4Qr00b2XzJ.mp3)

显示的效果如下：

表格

Markdown 使用 | 来分隔每列，使用 - 来分隔表头和内容。

例如：


| 表头1 | 表头2 | 表头3 |
|-------|-------|-------|
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

显示的效果如下：

表头1	表头2	表头3
单元格1	单元格2	单元格3
单元格4	单元格5	单元格6

对齐方式

markdown可以通过在分隔行的两侧添加冒号来设置列的对齐方式，冒号在左侧为左对齐，两侧都有为居中对齐，在右侧为右对齐。

例如：


| 左对齐  | 居中对齐 | 右对齐  |
|:-------|:--------:|-------:|
| 单元格1 | 单元格2  | 单元格3 |
| 单元格4 | 单元格5  | 单元格6 |

显示的效果如下：

左对齐	居中对齐	右对齐
单元格1	单元格2	单元格3
单元格4	单元格5	单元格6

Markdown 支持在表格的单元格中使用其他的markdown语法。