Markdown语法完全指南

Markdown 是一种轻量级标记语言，让你用简单的纯文本格式编写文档，然后转换成结构化的 HTML。

1. 标题

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

效果

一级标题

二级标题

三级标题

 

2. 文本样式

**粗体文本**
__粗体文本__

*斜体文本*
_斜体文本_

***粗斜体文本***
___粗斜体文本___

~~删除线~~

<u>下划线</u>

效果

粗体文本

斜体文本

粗斜体文本

删除线

下划线

 

3. 列表

无序列表

- 项目 1
- 项目 2
  - 子项目 2.1
  - 子项目 2.2
- 项目 3

* 也可以用星号
+ 或者加号

注1：也可以用*（星号）和+（加号）

注2：+和-是圆点，*是方点

效果

• 项目 1
• 项目 2
  • 子项目 2.1
  • 子项目 2.2
• 项目 3

有序列表

1. 第一项
2. 第二项
3. 第三项
   1. 子项一
   2. 子项二

效果

1. 第一项
2. 第二项
3. 第三项
   1. 子项一
   2. 子项二

任务列表

- [x] 已完成任务
- [x] 已完成任务 2
- [ ] 未完成任务
- [ ] 未完成任务 2

效果

☑ 已完成任务

☑ 已完成任务 2

☐ 未完成任务

☐ 未完成任务 2

 

4. 链接

[链接文字](https://www.example.com)
[带标题的链接](https://www.example.com "鼠标悬停显示")

效果

链接文字
带标题的链接

 

5. 图片

![头像](https://pic.cnblogs.com/avatar/a78946.jpg)

效果

 

6. 引用

> 这是一段引用文字
> 可以有多行

> 引用可以嵌套
>> 二级引用
>>> 三级引用

> **引用中可以使用其他格式**
> - 列表项 1
> - 列表项 2

效果

这是一段引用文字 可以有多行

引用可以嵌套

二级引用

三级引用

 

7. 代码

行内代码

使用 `console.log()` 输出日志

效果

使用 console.log() 输出日志

代码块

```javascript
function hello() {
    console.log("Hello, World!");
}
```

```python
def hello():
    print("Hello, World!")
```

```bash
echo "Hello, World!"
```

效果

function hello() {

    console.log("Hello, World!");

}

常用语言标识

语言	标识
JavaScript	javascript 或 js
Python	python 或 py
Java	java
C++	cpp 或 c++
C	c
Shell	bash 或 shell
SQL	sql
JSON	json
HTML	html
CSS	css

 

8. 表格

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 单元格 | 单元格   | 单元格 |
| 数据1  | 数据2    | 数据3  |

<!-- 简化写法 -->
列1 | 列2 | 列3
----|-----|----
A   | B   | C
D   | E   | F

效果

左对齐	居中对齐	右对齐
单元格	单元格	单元格
数据1	数据2	数据3

 

9. 分隔线

---
***
___
- - -
* * *

效果

---

 

10. 转义字符

\*不是斜体\*
\# 不是标题
\[不是链接\]

需要转义的字符：
\   反斜杠
`   反引号
*   星号
_   下划线
{}  大括号
[]  中括号
()  小括号
#   井号
+   加号
-   减号
.   点
!   感叹号

效果

*不是斜体*

 

11. HTML 支持

<div align="center">
  <h3>居中标题</h3>
  <p>居中段落</p>
</div>

<details>
<summary>点击展开</summary>

这里是隐藏的内容

- 列表项 1
- 列表项 2

</details>

<kbd>Ctrl</kbd> + <kbd>C</kbd>

上标：X<sup>2</sup>
下标：H<sub>2</sub>O

<font color="red">红色文字</font>

效果

居中标题

居中段落

点击展开

这里是隐藏的内容

• 列表项 1

• 列表项 2

 

Ctrl + C

上标：X²
下标：H₂O

红色文字

 

12. 数学公式（LaTeX）

行内公式

质能方程：$E = mc^2$

效果

质能方程：$E = mc^2$ 

块级公式

$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

效果

$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

 

13. 流程图（Mermaid）

```mermaid
flowchart TD
    A[开始] --> B{条件判断}
    B -->|是| C[执行操作]
    B -->|否| D[结束]
    C --> D
```

效果

 

14. 徽章/Badge

[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
![prs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)

效果

 

更多请参考：https://github.com/hawtim/badge-collection