Markdown 常用语法完全指南

Markdown 是一种轻量级标记语言，让你用纯文本格式编写文档，广泛用于技术文档、博客写作、GitHub README 等场景。本文整理了 Markdown 的常用语法，从基础到进阶，方便日常查阅。

1. 基础语法

1.1 标题

使用 # 号标记标题，一个 # 是一级标题，最多支持六级。

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

1.2 文本样式

**粗体文本**
*斜体文本*
***粗斜体文本***
~~删除线文本~~
`行内代码`

效果展示：

粗体文本
斜体文本
粗斜体文本
~~删除线文本~~
行内代码

1.3 引用

使用 > 符号创建引用，支持多层嵌套。

> 这是一段引用
>
> > 这是嵌套引用
> >
> > > 三层嵌套

这是一段引用

这是嵌套引用

三层嵌套

1.4 分割线

使用三个或以上的 -、*、_ 创建分割线。

1
2
3

---
***
___

1.5 段落与换行

段落之间用一个空行分隔
行末添加两个空格 + 回车，可以实现段内换行
直接回车不会换行（会被合并到同一段落）

2. 列表

2.1 无序列表

使用 -、+ 或 * 创建无序列表，支持嵌套。

- 第一项
- 第二项
  - 嵌套项 A
  - 嵌套项 B
    - 更深层嵌套
+ 第三项
* 第四项

第一项
第二项
- 嵌套项 A
- 嵌套项 B
  - 更深层嵌套

第三项

第四项

2.2 有序列表

使用数字加 . 创建有序列表。

1. 第一步
2. 第二步
3. 第三步
   1. 子步骤 3.1
   2. 子步骤 3.2

第一步
第二步
第三步
1. 子步骤 3.1
2. 子步骤 3.2

2.3 任务列表

使用 - [ ] 或 - [x] 创建任务列表（GitHub 风格）。

1
2
3

- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个待办事项

已完成的任务
未完成的任务
另一个待办事项

3. 链接与图片

3.1 超链接

1
2
3

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

3.2 图片

1 2	`![图片描述](https://example.com/image.png) ![带标题的图片](https://example.com/image.png "图片标题")`

3.3 引用式链接

当链接需要多次引用时，可以使用引用式写法：

1
2
3

[链接文字][id]

[id]: https://example.com "可选标题"

4. 代码

4.1 行内代码

使用反引号 ` 包裹：

1	使用 `console.log()` 打印日志

4.2 代码块

使用三个反引号包裹，并在开头指定语言实现语法高亮：

1
2
3

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


常见语言标识：

| 语言         | 标识                  |
| ---------- | ------------------- |
| Python     | `python` / `py`     |
| JavaScript | `javascript` / `js` |
| Java       | `java`              |
| C/C++      | `c` / `cpp`         |
| Bash       | `bash` / `sh`       |
| SQL        | `sql`               |
| JSON       | `json`              |
| YAML       | `yaml` / `yml`      |
| Markdown   | `markdown` / `md`   |
| HTML       | `html`              |
| CSS        | `css`               |
| Go         | `go`                |
| Rust       | `rust`              |
| TypeScript | `typescript` / `ts` |

### 4.3 缩进代码块

使用 4 个空格或 1 个 Tab 缩进也可以创建代码块（不支持语法高亮）：

    这是一个缩进代码块
    每行前面需要 4 个空格

---

## 5. 表格

使用 `|` 分隔列，使用 `-` 分隔表头和表体。

```markdown
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:-------:|-------:|
| 数据1  |  数据2  |  数据3 |
| 数据4  |  数据5  |  数据6 |

左对齐	居中对齐	右对齐
数据1	数据2	数据3
数据4	数据5	数据6

对齐方式说明：

:--- 或 ---：左对齐（默认）
:---:：居中对齐
---:：右对齐

6. 数学公式

使用单个 $ 包裹行内公式，使用 $$ 包裹独立公式块。

6.1 行内公式

1	`质能方程 $E = mc^2$ 是物理学中最著名的公式之一。`

6.2 公式块

1
2
3

$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$

6.3 常用 LaTeX 语法

类型	语法	效果
上标	`x^2`	x^2
下标	`x_i`	x_i
分数	`\frac{a}{b}`	a/b
根号	`\sqrt{x}`	sqrt(x)
求和	`\sum_{i=1}^n`	sum
积分	`\int_a^b`	integral
希腊字母	`\alpha \beta \gamma`	希腊字母
矩阵	`\begin{pmatrix} a & b \\ c & d \end{pmatrix}`	矩阵

7. 脚注与注释

7.1 脚注

1
2
3

这是一个需要脚注的句子[^1]。

[^1]: 这是脚注的具体内容。

这是一个需要脚注的句子^[1]。

7.2 HTML 注释

Markdown 支持嵌入 HTML，可以使用 HTML 注释隐藏内容：

1	`<!-- 这段注释不会在渲染结果中显示 -->`

8. 高级语法

8.1 定义列表

部分 Markdown 扩展支持定义列表（需渲染器支持）：

1 2	`术语 : 定义说明`

8.2 缩写

*[HTML]: 超文本标记语言
*[CSS]: 层叠样式表

HTML 和 CSS 是前端开发的基础。

8.3 高亮标记

使用 ==文本== 标记高亮（需渲染器支持，如 mark 标签）：

1	`==这是高亮文本==`

8.4 上标与下标

部分渲染器支持：

1 2	`H~2~O 是水的化学式 E = mc^2^`

8.5 键盘按键

使用 <kbd> 标签：

1	`按 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制`

效果：按 Ctrl + C 复制

9. HTML 嵌入

Markdown 允许直接嵌入 HTML 标签：

9.1 折叠内容

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

这里是隐藏的内容，支持 Markdown 语法。

- 列表项 1
- 列表项 2

</details>

9.2 居中对齐

1
2
3

<div align="center">
这段文字居中显示
</div>

9.3 颜色文字

1 2	`<span style="color: red;">红色文字</span> <span style="color: #30a9de;">自定义颜色</span>`

9.4 表格合并单元格

<table>
  <tr>
    <th colspan="2">合并两列</th>
  </tr>
  <tr>
    <td>单元格 1</td>
    <td>单元格 2</td>
  </tr>
</table>

10. GitHub / Hexo 扩展语法

10.1 Emoji

使用冒号包裹 emoji 短代码：

1	`:smile: :heart: :rocket: :thumbsup: :fire:`

常见 emoji 列表：

短代码	显示	短代码	显示
`:smile:`	:smile:	`:heart:`	:heart:
`:rocket:`	:rocket:	`:fire:`	:fire:
`:star:`	:star:	`:+1:`	:+1:
`:wave:`	:wave:	`:checkered_flag:`	:checkered_flag:
`:warning:`	:warning:	`:bulb:`	:bulb:

10.2 提及与链接

1
2
3

@用户名          # 提及用户
#123             # 引用 Issue
GH-123           # 引用 Issue（部分平台）

10.3 警告框（GitHub 风格）

> [!NOTE]
> 这是一条备注信息。

> [!TIP]
> 这是一条提示信息。

> [!WARNING]
> 这是一条警告信息。

> [!CAUTION]
> 这是一条危险警告。

11. 流程图与图表（Mermaid）

Hexo 和 GitHub 都支持 Mermaid 语法绘制图表：

11.1 流程图

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

11.2 时序图

sequenceDiagram
    participant A as 用户
    participant B as 服务器
    A->>B: 发送请求
    B-->>A: 返回响应

11.3 饼图

pie
    title 编程语言使用比例
    "Python" : 40
    "JavaScript" : 30
    "Go" : 15
    "其他" : 15

12. 快捷键速查

操作	快捷键（常见编辑器）
加粗	`Ctrl + B`
斜体	`Ctrl + I`
链接	`Ctrl + K`
行内代码	Ctrl + `
标题	`Ctrl + Shift + H`
有序列表	`Ctrl + Shift + O`
无序列表	`Ctrl + Shift + U`
引用	`Ctrl + Shift + Q`
预览	`Ctrl + Shift + V`

13. 常见问题

13.1 特殊字符转义

使用反斜杠 \ 转义特殊字符：

1
2
3

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

13.2 空格与缩进

中英文之间添加空格，提升可读性（推荐但非必须）
列表嵌套需要缩进 2 或 4 个空格
引用中的列表需要在 > 后面添加空格

13.3 图片居中

Markdown 原生不支持图片居中，可以使用 HTML：

1
2
3

<div align="center">
  <img src="image.png" alt="描述" width="400">
</div>

或者引用式写法配合 CSS：

1	`![描述](image.png){: .center}`

14. 推荐工具

工具	平台	特点
Typora	Windows/Mac/Linux	所见即所得，体验最佳
VS Code + 插件	全平台	免费，配合 Markdown All in One 插件
Mark Text	全平台	开源免费，类似 Typora
Obsidian	全平台	知识管理 + Markdown 编辑
Notion	全平台	团队协作，支持 Markdown 快捷输入
StackEdit	网页版	在线编辑，支持同步 Google Drive

以上就是 Markdown 常用语法的完整整理。建议收藏本文，写作时随时查阅。熟练掌握这些语法后，无论是写技术文档、博客文章还是日常笔记，都能得心应手。

这是脚注的具体内容。 ↩

文档

#效率工具 #Markdown #写作

Markdown 常用语法完全指南

https://asteriayx.github.io/2026/06/15/markdown-guide/

作者

Asteriayx

发布于

2026年6月15日

更新于

2026年8月6日

许可协议

LubanCat-3 (RK3576) 安装 Realtek RTL8851BU WiFi+蓝牙驱动全流程上一篇

Ksmartshop 资源网介绍与 Gemini Pro 会员获取指南下一篇