Markdown 语法完全指南

宋涛2025年4月4日大约 3 分钟

Markdown 是一种轻量级标记语言，通过简洁的语法实现快速排版，适用于编写文档、笔记、博客等场景。本文全面整理 Markdown 的核心语法规则，并提供直观示例，助您快速掌握高效排版技巧。

1. 标题

语法	示例	效果
`# H1`	`# 一级标题`	一级标题
`## H2`	`## 二级标题`	二级标题
`### H3`	`### 三级标题`	三级标题
`#### H4`	`#### 四级标题`	四级标题
Alt 语法 (H1/H2)	`一级标题\n=========`	同 `# 一级标题`
	`二级标题\n---------`	同 `## 二级标题`

2. 文本格式

功能	语法	示例	效果
加粗	`文本` 或 `__文本__`	`重要内容`	重要内容
斜体	`文本` 或 `_文本_`	`强调文字`	强调文字
~~删除线~~	`~~文本~~`	`~~过时信息~~`	~~过时信息~~
高亮	`==文本==`	`==关键段落==`	关键段落（需支持扩展）
组合格式	`_混合样式_`	`_加粗+斜体_`	*加粗+斜体*

3. 列表

无序列表

- 项目一
- 项目二
  - 子项目（缩进 2 空格）
  - 子项目二
* 使用 `*` 或 `+` 亦可

效果：

项目一
项目二
- 子项目
- 子项目二

有序列表

1. 第一步
2. 第二步
   1. 子步骤（缩进 3 空格）
   2. 子步骤二

效果：

第一步
第二步
1. 子步骤
2. 子步骤二

4. 链接与图片

类型	语法	示例
行内链接	`[显示文本](URL "标题")`	`[Google](https://google.com "搜索")` → Google
引用链接	`[显示文本][id]` + `[id]: URL`	`[百度][1]` + `[1]: https://baidu.com` → 百度
图片	`![替代文字](图片URL "标题")`	`![Logo](logo.png "图标")` → 显示图片
图片链接	`[![图片](img.png)](链接URL)`	点击图片跳转

5. 代码块与行内代码

行内代码

语法：用反引号包裹 `代码`
示例：`print("Hello")` → print("Hello")

代码块

基础语法：每行缩进 4 空格或 1 Tab

围栏语法（支持语言高亮）：

```python
def hello():
    print("Markdown 语法指南")
```

效果：

def hello():
    print("Markdown 语法指南")

6. 表格

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 单元格 | 单元格   | 单元格 |
| **加粗** | *斜体*   | ~~删除~~ |

效果：

左对齐	居中对齐	右对齐
单元格	单元格	单元格
加粗	斜体	删除

7. 引用与注释

块引用

> 这是引用内容
> 多行时添加 `>` 符号
> > 嵌套引用

效果：

这是引用内容
多行时添加 > 符号
嵌套引用

脚注

这是一个脚注示例[^1]
[^1]: 脚注的详细说明

8. 分割线与转义符

分割线：三个及以上 -、* 或 _
--- →
转义符：用 \ 显示特殊符号
\*正常显示星号\* → 正常显示星号

9. HTML 支持

Markdown 支持内嵌 HTML 标签：

<span style="color:red">红色文字</span>
<kbd>Ctrl</kbd>+<kbd>C</kbd> 复制

效果：
红色文字
Ctrl+C 复制

10. 高级技巧

任务列表

- [x] 已完成任务
- [ ] 待办事项

效果：

已完成任务
待办事项

自动链接

<https://example.com> → https://example.com

目录生成

部分工具（如 Typora）支持 [TOC] 自动生成目录

11. 总结

Markdown 的核心优势在于 简洁性 与 跨平台兼容性。关键要点：

基础语法：标题、列表、代码块需优先掌握
高效排版：表格、引用、HTML 增强表现力
工具适配：不同编辑器对扩展语法支持可能不同

Markdown 语法完全指南

一级标题

二级标题

三级标题

四级标题