Markdown语法说明

一、标题

1、使用=和-标记一级和二级标题

= 和 - 标记语法格式如下：
代码：

1
2
3
4
5
我展示的是一级标题
=================

我展示的是二级标题
-----------------

效果：

我展示的是一级标题

我展示的是二级标题

2、在想要设置为标题的文字前面加#来表示

一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。

注：标准语法一般在#后跟个空格再写文字，貌似简书不加空格也行。

示例：

1
2
3
4
5
6
7
8
9
10
11
# 这是一级标题

## 这是二级标题

### 这是三级标题

#### 这是四级标题

##### 这是五级标题

###### 这是六级标题

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

二、字体

代码：

1
2
3
4
5
6
7
**这是加粗的文字**

*这是倾斜的文字*`

***这是斜体加粗的文字***

~~这是加删除线的文字~~

效果：

这是加粗的文字

这是倾斜的文字`

这是斜体加粗的文字

这是加删除线的文字

三、引用

在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>>n个…

貌似可以一直加下去，但没神马卵用

代码：

1
2
3
>这是引用的内容
>>这是引用的内容
>>>这是引用的内容

效果：

这是引用的内容

这是引用的内容

这是引用的内容

四、分割线

三个或者三个以上的 - 或者 * 都可以。

代码：

1
2
3
4
---
----
***
*****

效果：

—-

五、图片

Markdown 图片语法格式如下：

1
2
3
![alt 属性文本](图片地址)

![alt 属性文本](图片地址 "可选标题")

图片alt就是显示在图片下面的文字，相当于对图片内容的解释。图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加
代码：

1
![blog 图标](alom.com.cn/picture/src/old/20191108155002301.jpg "blog show")

效果：

blog 图标

六、超链接

语法：

[超链接名](超链接地址"超链接title")title可加可不加

示例代码1（行内超链接）：

1
2
3
[简书](http://jianshu.com)

[百度](http://baidu.com)

效果：

简书

百度

示例代码2（参考超链接）：

1
2
I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].

效果：

I get 10 times more traffic from Google than from Yahoo or MSN.

示例代码3(脚注)：

1
2
3
这是一个链接到谷歌的[^脚注1]。

[^脚注1]: http://www.google.com

效果：

这是一个链接到谷歌的脚注1。

脚注1. http://www.google.com ↩

示例代码4 ：

直接使用链接地址：

1
<https://www.runoob.com>

效果：

https://www.runoob.com

七、列表

无序列表

语法：无序列表用 - + * 任何一种都可以

代码：

1
2
3
4
5
6
- 列表内容1
   - A
   - B
+ 列表内容2
   - A
   - B

效果：

  • 列表内容
    • A
    • B
  • 列表内容
    • A
    • B

有序列表

语法：数字加点

代码：

1
2
3
4
5
6
7
1.列表内容
   - 1.1
   - 1.2

2.列表内容
   - 2.1
   - 2.2

效果：

1.列表内容

  • 1.1
  • 1.2

2.列表内容

  • 2.1
  • 2.2

注意：序号跟内容之间要有空格

八、表格

语法：

1
2
3
4
| 左对齐 | 右对齐 | 居中对齐 |
| :--| --: | :--: |
| a | b | c |
| a | b | c |

效果：

左对齐 右对齐 居中对齐
a b c
a b c

九、代码

单行代码：代码之间分别用一个反引号包起来

代码：

1
`代码内容`

效果：

代码内容

代码块：代码之间分别用三个反引号包起来，且两边的反引号单独占一行

1
2
3
```
line1
line2

1
效果：

line1
line2
1
2
3
4
5
6
7
8
9

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

    111

## 十、流程图

1、横向流程图源码格式：
代码：

1
2
3
4
5
6
graph LR
    A[方形] -->B(圆角)
    B --> C{条件a}
    C -->|a=1| D[结果1]
    C -->|a=2| E[结果2]
    F[横向流程图]

1
2
3
4
5
6
7
8
效果：
```mermaid
graph LR
    A[方形] -->B(圆角)
    B --> C{条件a}
    C -->|a=1| D[结果1]
    C -->|a=2| E[结果2]
    F[横向流程图]

2、竖向流程图源码格式：
代码：

1
2
3
4
5
6
7
```mermaid
graph TD
A[方形] --> B(圆角)
    B --> C{条件a}
    C --> |a=1| D[结果1]
    C --> |a=2| E[结果2]
    F[竖向流程图]

1
2
3
4
5
6
7
8
效果：
```mermaid
graph TD
A[方形] --> B(圆角)
    B --> C{条件a}
    C --> |a=1| D[结果1]
    C --> |a=2| E[结果2]
    F[竖向流程图]

3、标准流程图源码格式：
代码：
1
2
3
4
5
6
7
8
9
10
11
   ```mermaid
flowchat
st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st->op->cond
cond(yes)->io->e
cond(no)->sub1(right)->op

1
2
3
4
5
6
7
8
9
10
11
12
效果：
```mermaid
flowchat
st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st->op->cond
cond(yes)->io->e
cond(no)->sub1(right)->op

4、标准流程图源码格式（横向）：
代码：

1
2
3
4
5
6
7
8
9
10
11
```mermaid
flowchat
st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st(right)->op(right)->cond
cond(yes)->io(bottom)->e
cond(no)->sub1(right)->op

1
2
3
4
5
6
7
8
9
10
11
12
效果：
```mermaid
flowchat
st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st(right)->op(right)->cond
cond(yes)->io(bottom)->e
cond(no)->sub1(right)->op

5、UML时序图源码样例：
代码：
1
2
3
4
5
6
7
```mermaid
sequenceDiagram
对象A->>对象B: 对象B你好吗?（请求）
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->>对象A: 我很好(响应)
对象A->>对象B: 你真的好吗？

1
2
3
4
5
6
7
8
效果：
```mermaid
sequenceDiagram
对象A->>对象B: 对象B你好吗?（请求）
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->>对象A: 我很好(响应)
对象A->>对象B: 你真的好吗？

6、UML时序图源码复杂样例：
代码：
1
2
3
4
5
6
7
8
9
10
11
12
13
```mermaid
sequenceDiagram
Title: 标题：复杂使用
对象A->>对象B: 对象B你好吗?（请求）
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->>对象A: 我很好(响应)
对象B->>小三: 你好吗
小三-->>对象A: 对象B找我了
对象A->>对象B: 你真的好吗？
Note over 小三,对象B: 我们是朋友
participant C
Note right of C: 没人陪我玩

1
2
3
4
5
6
7
8
9
10
11
12
13
14
效果：
```mermaid
sequenceDiagram
Title: 标题：复杂使用
对象A->>对象B: 对象B你好吗?（请求）
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->>对象A: 我很好(响应)
对象B->>小三: 你好吗
小三-->>对象A: 对象B找我了
对象A->>对象B: 你真的好吗？
Note over 小三,对象B: 我们是朋友
participant C
Note right of C: 没人陪我玩

7、UML标准时序图样例：
代码：
1
2
3
4
5
6
7
8
9
10
11
12
```mermaid
    sequenceDiagram
    participant 张三
    participant 李四
    张三->王五: 王五你好吗？
    loop 健康检查
        王五->王五: 与疾病战斗
    end
    Note right of 王五: 合理 食物 <br/>看医生...
    李四-->>张三: 很好!
    王五->李四: 你怎么样?
    李四-->王五: 很好!

1
2
3
4
5
6
7
8
9
10
11
12
13
效果：
```mermaid
    sequenceDiagram
    participant 张三
    participant 李四
    张三->王五: 王五你好吗？
    loop 健康检查
        王五->王五: 与疾病战斗
    end
    Note right of 王五: 合理 食物 <br/>看医生...
    李四-->>张三: 很好!
    王五->李四: 你怎么样?
    李四-->王五: 很好!

8、甘特图样例：
代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
```mermaid
        gantt
        dateFormat  YYYY-MM-DD
        title 软件开发甘特图
        section 设计
        需求                      :done,    des1, 2014-01-06,2014-01-08
        原型                      :active,  des2, 2014-01-09, 3d
        UI设计                     :         des3, after des2, 5d
    未来任务                     :         des4, after des3, 5d
        section 开发
        学习准备理解需求                      :crit, done, 2014-01-06,24h
        设计框架                             :crit, done, after des2, 2d
        开发                                 :crit, active, 3d
        未来任务                              :crit, 5d
        耍                                   :2d
        section 测试
        功能测试                              :active, a1, after des3, 3d
        压力测试                               :after a1  , 20h
        测试报告                               : 48h

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
效果：
```mermaid
        gantt
        dateFormat  YYYY-MM-DD
        title 软件开发甘特图
        section 设计
        需求                      :done,    des1, 2014-01-06,2014-01-08
        原型                      :active,  des2, 2014-01-09, 3d
        UI设计                     :         des3, after des2, 5d
    未来任务                     :         des4, after des3, 5d
        section 开发
        学习准备理解需求                      :crit, done, 2014-01-06,24h
        设计框架                             :crit, done, after des2, 2d
        开发                                 :crit, active, 3d
        未来任务                              :crit, 5d
        耍                                   :2d
        section 测试
        功能测试                              :active, a1, after des3, 3d
        压力测试                               :after a1  , 20h
        测试报告                               : 48h

Markdown 高级技巧

支持的 HTML 元素
不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。

目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等 ，如：

1
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

效果：

使用 Ctrl+Alt+Del 重启电脑

转义字符：

代码：

1
2
**文本加粗** 
\*\* 正常显示星号 \*\*

效果：

文本加粗
** 正常显示星号 **

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

1
2
3
4
5
6
7
8
9
10
11
12
\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

公式

当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如：

在这里插入图片描述