Markdown九大常用语法详解及示例

一、标题

语法：n个# 第n级标题文字

一个 # 为一级标题，两个 # 是二级标题，以此类推，最多支持六级标题。# 与标题文字之间需要加一个空格。
注意：仅支持半角的#，不支持全角的＃。

示例

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

预览

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

这是六级标题

二、字体格式

1. 加粗

语法： **要加粗的文字**

示例

**我是粗体**

预览

我是粗体

2. 斜体

语法： *要倾斜的文字*

示例

*我是斜体*

预览

我是斜体

3. 斜体加粗

语法：***要斜体加粗的文字***

示例

***我是加粗的斜体***

预览

我是加粗的斜体

4. 删除线

语法： ~~要加删除线的文字~~

示例

 ~~我是加了删除线的文字~~

预览

我是加了删除线的文字

三、引用

语法：n个>要引用的文字

可以嵌套引用，一个>为一级引用，两个>>为二级引用，以此类推。

示例

>一级引用的内容
>>二级引用的内容
>>>三级引用的内容

预览

一级引用的内容

二级引用的内容

三级引用的内容

四、 分割线

语法：--- 或 ***

连续三个及以上的- 或 连续三个及以上的*（必需单独一行）

示例

---
***

预览

---

---

五、超链接与图片

超链接语法：[超链接名](超链接地址)

示例

\[淘宝](www.taobao.com)

预览

淘宝

图片语法：

注意：插入图片和插入超链接的语法很像，只是前面多加一个英文叹号。

六、列表

1. 无序列表

语法：-/+/* 列表内容

注意：-/+/*与列表内容间需要有一个空格

示例

- 这是一个列表
+ 这也是一个列表
* 这还是一个列表

预览

• 这是一个列表

• 这也是一个列表

• 这还是一个列表

2. 有序列表

语法：数字. 列表内容

注意：序号与列表内容间需要有一个空格

示例

 1. 第一条列表
 2. 第二条列表
 3. 第三条列表

预览

1. 第一条列表
2. 第二条列表
3. 第三条列表

3. 列表嵌套

语法：写完上一级列表后回车，下一级列表句首敲三个空格

示例

 - 一级列表
    - 二级列表1
    - 二级列表2
       * 三级列表1
       * 三级列表2

预览

• 一级列表
  • 二级列表1
  • 二级列表2
    • 三级列表1
    • 三级列表2

七、表格

语法：

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

第二行分割表头和内容。文字默认左对齐。

第二行中，每列的-有一个或多个的效果是一样的。

每列的-右边加:则该列文字右对齐。

每列的-两边都加:则该列文字居中。

示例

|姓名|学号|成绩|
|---|:---:|---:|
|张三|001|89|
|李四|002|96|
|王二|003|82|

预览

姓名	学号	成绩
张三	001	89
李四	002	96
王二	003	82

八、代码

单行代码语法：`代码内容`

注意：这里是用反引号把代码包起来，并非是单引号。

示例：

`import pandas as pd`

预览

import pandas as pd

代码块语法：

```
第一行代码

第二行代码

第三行代码
```

示例
注意：此处```前加\是为了转义，正常使用时不需要加。

\```
def print_func():
    print("hello world!")
    print("fighting!")

\```

预览

def print_func():
    print("hello world!")
    print("fighting!")

九、待办事项

语法：

• [ ] 待办事项
• [x] 已办事项

注意：-与[]之间、[]内必须有空格

示例

- [ ] 待办事项1
  - [ ] 待办事项1
  - [ ] 待办事项2
- [x] 已办事项

预览

image.png

PS:并不是所有的markdown编辑器都支持以上所有功能，比如就不支持待办事项。但大部分功能都是通用的。

希望能帮到你~