Markdown 使用指南（完全版）

目录

• 1. 斜体、粗体、删除线、下划线、背景高亮
• 2. 字体、字号、颜色
• 3. 缩进、换行、空行、对齐方式
• 4. 分级标题
• 5. 外链接
• 6. 锚点
• 7. 无序列表
• 8. 有序列表
• 9. 文字引用
• 10. 行内代码块
• 11. 代码块
• 12. 注释
• 13. 插入图像
• 14. 内容目录
• 15. 注脚
• 15. 分割线
• 16. 转义符
• 17. LaTeX公式
• 18. 待办事项【博客园不支持】
• 19. 表格支持
• 20. 流程图【博客园不支持】
• 21. 序列图【博客园不支持】
• 22. 甘特图
• 23. 特殊字符

---

1. 斜体、粗体、删除线、下划线、背景高亮

*斜体*
**粗体**
***加粗斜体***
~~删除线~~
<u>下划线</u>
<mark>背景高亮</mark>

示例：

斜体 粗体 加粗斜体 删除线 下划线 背景高亮

2. 字体、字号、颜色

<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>
<font color=#0099ff size=6 face="黑体">黑体</font>
<font color=gray size=5>gray</font>
<font color=#00ffff size=3>Java</font>

我是黑体字
我是微软雅黑
我是华文彩云
黑体
gray
Java

3. 缩进、换行、空行、对齐方式

【缩进】
  //全角 
  //半角

【换行】
Enter 正常行
Shift + Enter 窄行

【空行】
<br/>

【对齐方式】
<center>行中心对齐</center>
<p align="left">行左对齐</p>
<p align="right">行右对齐</p>

4. 分级标题

# 一级标题
## 二级标题
...
##### 五级标题
###### 六级标题 <!--最多6级标题-->

5. 外链接

【行内式】
欢迎来到[本人博客](https://www.cnblogs.com/QingPingZm/)
欢迎来到[本人博客](https://www.cnblogs.com/QingPingZm/ "本人博客")

【参考式】建议链接部分置于文章底部
我经常去的几个网站 [博客园][1]、[本人博客][2]

[1]:https://www.cnblogs.com/ "博客园"
[2]:https://www.cnblogs.com/QingPingZm/ "本人博客"

【自动链接】
<https://www.cnblogs.com/QingPingZm/>

示例：

欢迎来到本人博客
欢迎来到本人博客

我经常去的几个网站 博客园、本人博客

https://www.cnblogs.com/QingPingZm/

6. 锚点

跳转到[目录](#index)

【设置目录锚点】
<a name="index"></a> 
或
标题后面加 {#index}

示例：

跳转到目录

7. 无序列表

【支持列表嵌套】
- 无序列表项 1
- 无序列表项 2
	- 项1.1
		- 项1.1.1
- 无序列表项 3

示例：

• 无序列表项 1
• 无序列表项 2
  • 项1.1
    • 项1.1.1
• 无序列表项 3

8. 有序列表

1. 有序列表项 1
2. 有序列表项 2
3. 有序列表项 3

示例：

1. 有序列表项 1
2. 有序列表项 2
3. 有序列表项 3

9. 文字引用

【支持随意嵌套】
>野火烧不尽，春风吹又生
>>野火烧不尽，春风吹又生
>>>野火烧不尽，春风吹又生

示例：

野火烧不尽，春风吹又生

野火烧不尽，春风吹又生

野火烧不尽，春风吹又生

10. 行内代码块

让我们聊聊 `html`

示例：

让我们聊聊 html

11. 代码块

使用 ``` ``` 表示代码块，这就是个代码块；可以选择语言来加强代码块

12. 注释

<!--注释-->

13. 插入图像

![图片描述](图片链接地址)
同外链接，也支持参考式
或
<img alt="图片描述" width="300" height="100" src="" />  可调整图片大小
或
<div align="center">
<img alt="图片描述" width="300" height="100" src="" />
</div>
可调整图片对齐方式

示例：

14. 内容目录

在段落中填写 [TOC] 以显示全文内容的目录结构，如篇头显示的内容目录

15. 注脚

【建议解释部分置于文章底部】
使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2]
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言

示例：

使用 Markdown^[1]可以效率的书写文档, 直接转换成 HTML^[2]

15. 分割线

***

示例：

---

16. 转义符

Markdown中的转义字符为\，转义项有：

转义项	说明
\	反斜线
`	反引号
*	星号
_	下划线
{}	花括号
[]	方括号
()	小括号
#	井字号
+	加号
-	减号
.	英文句点
!	感叹号

17. LaTeX公式

博客或者编辑器都需开启公式支持
【行内公式】
质能守恒方程可以用一个很简洁的方程式 $E=mc^2$ 来表达
【段落公式】
$$
\sum_{i=1}^n a_i=0
$$
$$
f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2
$$

示例：

质能守恒方程可以用一个很简洁的方程式 \(E=mc^2\) 来表达

\[\sum_{i=1}^n a_i=0 \]

\[f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 \]

18. 待办事项【博客园不支持】

- [x] 整理Markdown手册
- [ ] 改善项目
   - [x] 优化首页显示方式
   - [x] 修复闪退问题
   - [ ] 修复视频卡顿
- [ ] A3项目修复
   - [x] 修复数值错误

示例：

• 整理Markdown手册
• 改善项目
  • 优化首页显示方式
  • 修复闪退问题
  • 修复视频卡顿
• A3项目修复
  • 修复数值错误

19. 表格支持

【1】第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行
【2】第二行还可以为不同的列指定对齐方向，规则：- 左对齐、:-: 中心对齐、-: 右对齐
|学号|姓名|序号|
|-|-|-|
|小明明|男|5|
|小红|女|79|
|小陆|男|192|

示例：

学号	姓名	序号
小明明	男	5
小红	女	79
小陆	男	192

20. 流程图【博客园不支持】

​```flow
st=>start: 开始
io=>inputoutput: 验证
op=>operation: 选项
cond=>condition: 是 或 否？
sub=>subroutine: 子程序
e=>end: 结束

st->io->op->cond
cond(yes)->e
cond(no)->sub->io
​```

示例：

st=>start: 开始
io=>inputoutput: 验证
op=>operation: 选项
cond=>condition: 是 或 否？
sub=>subroutine: 子程序
e=>end: 结束

st->io->op->cond
cond(yes)->e
cond(no)->sub->io

21. 序列图【博客园不支持】

​```sequence
participant 客户端 as A
participant 服务端 as B
participant 通行证中心 as C
Note over A:用户输入通行证账号、密码
A->C: 发送账号、密码
Note over C:验证账号、密码
C-->>A:返回token
A->B:发送token
B->C:验证token
C-->>B:验证成功
B-->>A:登陆成功
Note left of A:左边注释
B->B:自交互
Note right of C:右边注释
​```

示例：

participant 客户端 as A
participant 服务端 as B
participant 通行证中心 as C
Note over A:用户输入通行证账号、密码
A->C: 发送账号、密码
Note over C:验证账号、密码
C-->>A:返回token
A->B:发送token
B->C:验证token
C-->>B:验证成功
B-->>A:登陆成功
Note left of A:左边注释
B->B:自交互
Note right of C:右边注释

22. 甘特图

​```mermaid
gantt
        dateFormat  YYYY-MM-DD
        
        title 软件开发甘特图
        
        section 设计
        需求:done,des1, 2019-01-06,2019-01-08
        原型:active,des2, 2019-01-09, 3d
        UI设计:des3, after des2, 5d
        未来任务:des4, after des3, 5d

        section 开发
        学习准备理解需求:crit, done, 2019-01-06,24h
        设计框架:crit, done, after des2, 2d
        开发:crit, active, 3d
        未来任务:crit, 5d
        休息时间:2d

        section 测试
        功能测试:active, a1, after des3, 3d
        压力测试:after a1, 20h
        测试报告: 48h
​```
【基本语法】
deteFormat 格式 指明日期的显示格式
title 标题 设置图标的标题
section 描述 定义纵向上的一个环节
定义步骤：
	每个步骤有两种状态 done（已完成）/ active（执行中）
	描述: 状态,id,开始日期,结束日期/持续时间
	描述: 状态[,id],after id2,持续时间
	crit ：可用于标记该步骤需要被修正，将高亮显示
	如果不指定具体的开始时间或在某个步骤之后，将默认依次顺序排列

示例：

gantt dateFormat YYYY-MM-DD title 软件开发甘特图 section 设计 需求:done,des1, 2019-01-06,2019-01-08 原型:active,des2, 2019-01-09, 3d UI设计:des3, after des2, 5d 未来任务:des4, after des3, 5d section 开发 学习准备理解需求:crit, done, 2019-01-06,24h 设计框架:crit, done, after des2, 2d 开发:crit, active, 3d 未来任务:crit, 5d 休息时间:2d section 测试 功能测试:active, a1, after des3, 3d 压力测试:after a1, 20h 测试报告: 48h

23. 特殊字符

特殊字符	描述	字符的代码
<	小于号	&lt;
>	大于号	&gt;
&	和号	&amp;
￥	人民币	&yen;
©	版权	&copy;
®	注册商标	&reg;
°C	摄氏度	&deg;C
±	正负号	&plusmn;
×	乘号	&times;
÷	除号	&divide;
²	平方（上标²）	&sup2;
³	立方（上标³）	&sup3;

【持续更新】

---

1. Markdown是一种纯文本标记语言 ↩︎

2. HyperText Markup Language 超文本标记语言 ↩︎