MarkDown的用法

MarkDown是什么？

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。

Markdown 语言在 2004 由约翰·格鲁伯（英语：John Gruber）创建。

Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。

Markdown 编写的文档后缀为 .md, .markdown。

标题

Markdown 标题有两种格式。

1. 使用=、-标记

使用=和-标记一级和二级标题，语法如下

<span style="background-color:#f8f8f8"><span style="color:#333333">我是一级标题
===
我是二级标题
---</span></span>

显示效果如下图所示：

2. 使用#标记

使用 # 号可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推

<span style="background-color:#f8f8f8"><span style="color:#333333"># 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题</span></span>

段落

Markdown 段落没有特殊的格式，直接编写文字就好，段落的换行是使用两个以上空格加上回车。

当然也可以在段落后面使用一个空行来表示重新开始一个段落。

分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#981a1a">***</span>
<span style="color:#981a1a">*</span> <span style="color:#981a1a">*</span> <span style="color:#981a1a">*</span>
<span style="color:#981a1a">*****</span>
<span style="color:#981a1a">-</span> <span style="color:#981a1a">-</span> <span style="color:#981a1a">-</span>
<span style="color:#981a1a">----------</span></span></span>

效果：

强调

斜体：我是斜体 我是斜体

粗体：我是粗体 我是粗体

删除线：我是删除线

下划线：我是下划线

脚注：我有脚注 Maye

[Maye] 顽石老师 -- 聪明又可爱！！

列表

Markdown 支持有序列表和无序列表。

无序列表： 无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记，这些标记后面要添加一个空格，然后再填写内容：

<span style="background-color:#f8f8f8"><span style="color:#333333">+ Name:顽石
- QQ:823861087
* Sex:男</span></span>

Name:顽石

QQ:823861087

Sex:男

有序列表：有序列表使用数字并加上 . 号来表示，如：

<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#116644">1.</span> <span style="color:#000000">Name</span>:<span style="color:#000000">顽石</span>
<span style="color:#116644">2.</span> <span style="color:#000000">QQ</span>:<span style="color:#116644">823861087</span>
<span style="color:#116644">3.</span> <span style="color:#000000">Sex</span>:<span style="color:#000000">男</span></span></span>

Name:顽石
QQ:823861087
Sex:男

列表嵌套

列表嵌套只需在子列表中的选项前面添加四个空格即可：

<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#116644">1.</span> <span style="color:#000000">第一项：</span><span style="color:#981a1a">-</span> <span style="color:#000000">第一项的第一个元素</span><span style="color:#981a1a">-</span> <span style="color:#000000">第一项的第二个元素</span>
<span style="color:#116644">2.</span> <span style="color:#000000">第二项</span>:<span style="color:#981a1a">+</span> <span style="color:#000000">第二项的第一个元素</span><span style="color:#981a1a">+</span> <span style="color:#000000">第二项的第二个元素</span></span></span>

第一项：
- 第一项的第一个元素
- 第一项的第二个元素
第二项:
- 第二项的第一个元素
- 第二项的第二个元素

区块引用

Markdown 区块引用是在段落开头使用 > 符号，然后后面紧跟一个空格符号：

<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#981a1a">></span> <span style="color:#000000">区块引用</span>
<span style="color:#981a1a">></span> <span style="color:#000000">顿开教育</span>
<span style="color:#981a1a">></span> <span style="color:#000000">让每个学员都学有所成</span>    </span></span>

区块引用顿开教育让每个学员都学有所成

另外区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推：

<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#981a1a">></span> <span style="color:#000000">最外层</span>
<span style="color:#981a1a">>></span> <span style="color:#000000">第一层</span>
<span style="color:#981a1a">>>></span> <span style="color:#000000">第二层</span></span></span>

最外层

第一层

第二层

区块中使用列表

<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#981a1a">></span> <span style="color:#000000">区块中使用列表</span>
<span style="color:#981a1a">></span> <span style="color:#116644">1.</span> <span style="color:#000000">one</span>
<span style="color:#981a1a">></span>     <span style="color:#981a1a">+</span> <span style="color:#000000">one1</span>
<span style="color:#981a1a">></span>     <span style="color:#981a1a">+</span> <span style="color:#000000">one2</span>
<span style="color:#981a1a">></span> <span style="color:#116644">2.</span> <span style="color:#000000">two</span>
<span style="color:#981a1a">></span> <span style="color:#116644">3.</span> <span style="color:#000000">three</span></span></span>

区块中使用列表

one

one1

one2

two

three

列表中使用区块

<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#981a1a">+</span> <span style="color:#000000">第一项</span><span style="color:#981a1a">></span> <span style="color:#000000">顿开教育</span><span style="color:#981a1a">></span> <span style="color:#000000">顽石老师</span>
<span style="color:#981a1a">+</span> <span style="color:#000000">第二项</span></span></span>

第一项

顿开教育顽石老师
第二项

代码

如果是段落上的一个函数或片段的代码可以用反引号把它包起来（代码），例如：

<span style="background-color:#f8f8f8"><span style="color:#333333">`printf()`函数</span></span>

printf()函数

代码块

代码区块使用 4 个空格或者一个制表符（Tab 键）。

<span style="background-color:#f8f8f8"><span style="color:#333333">void show()
{printf("顽石老师")
}</span></span>

你也可以用 ``` 包裹一段代码，并指定一种语言（也可以不指定）：

<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#008855">void</span> <span style="color:#0000ff">show</span>()
{<span style="color:#000000">printf</span>(<span style="color:#aa1111">"顽石老师"</span>)
}</span></span>

链接

内嵌式链接

外部链接：

链接使用方法如下：

<span style="background-color:#f8f8f8"><span style="color:#333333">[<span style="color:#000000">链接名称</span>](<span style="color:#000000">链接地址</span>)
<span style="color:#981a1a"><</span><span style="color:#000000">链接地址</span><span style="color:#981a1a">></span></span></span>

列如：

<span style="background-color:#f8f8f8"><span style="color:#333333">这是一个链接 [百度一下](<span style="color:#117700">www</span><span style="color:#555555">.baidu.com</span>)</span></span>

效果：这是一个链接百度一下

直接使用链接地址：

<span style="background-color:#f8f8f8"><span style="color:#333333"><www.baidu.com></span></span>

效果：www.baidu.com

内部链接：

内部链接可以跳转到文档得指定位置。

<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#999977">[</span>链接名称<span style="color:#999977">]</span>(#标题)</span></span>

效果：跳转到标题

引用式链接

我们可以通过变量来设置一个链接，变量赋值在文档末尾进行：

<span style="background-color:#f8f8f8"><span style="color:#333333">这个链接用1作为网址变量 <span style="color:#999977">[</span>Google<span style="color:#999977">][</span><span style="color:#221199">1</span><span style="color:#999977">]</span>
这个链接用baidu作为网址变量 <span style="color:#999977">[</span>Baidu<span style="color:#999977">][</span>baidu<span style="color:#999977">]</span>
这个链接用

在文档得几位为濒临赋值网址
<span style="color:#999977">[</span><span style="color:#221199">1</span><span style="color:#999977">]</span>: www.google.com
<span style="color:#999977">[</span>baidu<span style="color:#999977">]</span>: www.baidu.com</span></span>

这个链接用1作为网址变量 Google 这个链接用baidu作为网址变量 Baidu

这个链接用demo作为内部链接变量跳转到标题

在文档结尾为变量赋值网址

[1] https://www.google.com 谷歌网址

[baidu] https://www.baidu.com 百度网址

[demo] #标题

注意：变量最好简单易懂，不要用数字。

图片

Markdown 图片语法格式如下：

<span style="background-color:#f8f8f8"><span style="color:#333333">!<span style="color:#999977">[</span>alt 属性文本<span style="color:#999977">]</span>(图片地址 "可选标题")</span></span>

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

<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#981a1a">!</span>[<span style="color:#000000">百度图片</span>](<span style="color:#000000">https</span>:<span style="color:#aa5500">//www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)</span></span></span>

当然，你也可以像网址那样对图片网址使用变量:

<span style="background-color:#f8f8f8"><span style="color:#333333">!<span style="color:#999977">[</span>百度图片<span style="color:#999977">][</span>baidu_img<span style="color:#999977">]</span>

<span style="color:#999977">[</span>baidu_img<span style="color:#999977">]</span>: https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png</span></span>

[baidu_img] https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png

Markdown 还没有办法指定图片的高度与宽度，如果你需要的话，你可以使用普通的 <img> 标签。

<span style="background-color:#f8f8f8"><span style="color:#333333"><img src="https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png" width="50<span style="color:#aa5500">%"></span></span></span>

表格

Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。

语法格式如下：

<span style="background-color:#f8f8f8"><span style="color:#333333">|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |</span></span>

效果:

表头	表头
单元格	单元格
单元格	单元格

对齐方式

我们可以设置表格的对齐方式：

-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。

实例如下：

<span style="background-color:#f8f8f8"><span style="color:#333333">| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |</span></span>

效果：

左对齐	右对齐	居中对齐
单元格	单元格	单元格
单元格	单元格	单元格

emoji表情

MarkDown表情大全