Markdown常用语法

一、标题

• 方式一

用任何数量的 = 和 - 置于文字下方，分别表示H1和H2字体

示例：

This is an H1 
=========
This is an H2
-------------

效果：

This is an H1

This is an H2

• 方式二

在文字开头加上 “#”，通过“#”数量表示H1_{H6标题。（一共只有1}6级标题，1级标题字体最大）
示例：

#This is an H1
##This is an H2
###This is an H3
####This is an H4
#####This is an H5
######This is an H6

效果：

This is an H1

This is an H2

This is an H3

This is an H4

This is an H5

This is an H6

---

二、区块引用

在每行前或者段落第一行前加上 > 。同时可以嵌套，在需要嵌套的段落前加上多个 > 。
引用中同样可以使用Markdown语法。
示例：

> ## 这是一个标题。
> 
> >1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
>>这是一个嵌套
>>>再次嵌套
>
> 给出一些例子代码：
> 
>     let str: String = "Hello World!"

效果：

这是一个标题。

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

这是一个嵌套

再次嵌套

给出一些例子代码：

let str: String = "Hello World!"

---

三、列表

• 无序列表

无序列表使用星号、加号或是减号作为列表标记（*+-）
注：符号和内容指尖需要有空格
示例：

* 列表内容
+ 列表内容
- 列表内容

效果：

• 列表内容

• 列表内容

• 列表内容

• 有序列表

数字后接一个英文句点，不用在意数字序列
注：符号和内容指尖需要有空格
示例：

1. 列表内容
1. 列表内容
1. 列表内容

效果：

1. 列表内容
2. 列表内容
3. 列表内容

---

四、代码区块

• 单行代码

使用两个反引号（`）符号包含代码，如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段
注：不是单引号而是左上角的ESC下面~中的反引号
示例：

这是一行代码，多了一个反引号 (`)

效果：
这是一行代码，多了一个反引号 (`)

• 多行代码

每行缩进 4 个空格或是 1 个制表符
示例：

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

效果：

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

---

五、分割线

使用三个以上的星号、减号、底线（*-_）来建立一个分隔线，行内可以有空格，但不能有其它字符。
示例：

* * *
***
*****
- - -
---------------------------------------

效果：

---

---

---

---

---

六、链接

不管是哪一种，链接文字都是用 [方括号] 来标记。

• 行内式

语法：
[超链接名](超链接地址 "超链接title")
其中 title 可加可不加，若是链接相同主机资源，可以使用相对路径。
示例：

这是[百度](http://www.baidu.com)的链接

效果：
这是百度的链接

• 参考式

参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记。
示例：

[百度][1]、[谷歌][2]和[雅虎][3]都可以搜索内容。

[1]:  http://google.com/        "Google"
[2]: http://search.yahoo.com/  "Yahoo Search"
[3]: http://search.msn.com/    "MSN Search"

效果：
百度、谷歌和雅虎都可以搜索内容。

---

七、强调

使用星号（*）和底线（_）作为标记强调字词的符号。~作为删除符号
示例：

*这是倾斜的文字*
_这是倾斜的文字_
**这是加粗的文字**
__这是加粗的文字__
***这是斜体加粗的文字***
___这是斜体加粗的文字___
~~这是加删除线的文字~~

效果：
这是倾斜的文字
这是倾斜的文字
这是加粗的文字
这是加粗的文字
这是斜体加粗的文字
这是斜体加粗的文字
这是加删除线的文字

---

八、图片

和链接相似也分为两种：行内式和参考式

• 行内式

语法：
! [图片替代文字](图片地址 ''图片标题'')

• 一个惊叹号 !
• 接着一个方括号，里面放上图片的替代文字
• 接着一个圆括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。

示例：

  ! [onepiece](https://uploa '海贼王')

效果：

onepiece

---

九、表格

语法：

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
- 有一个就行，为了对齐，多加了几个
文字默认居左
-两边加：表示文字居中
-右边加：表示文字居右
注：原生的语法两边都要用 | 包起来。此处省略

示例：

表头	表头	表头
内容	内容	内容
内容	内容	内容