你想要了解 Markdown(MD)的所有核心语法,以便能够完整、规范地编写 Markdown 文档。我会为你系统梳理 Markdown 的常用语法,并附带示例和效果说明,让你能直观理解每种语法的用法。
Markdown 核心语法全解析
Markdown 语法分为基础语法(所有编辑器通用)和扩展语法(部分编辑器/平台支持,如 GitHub、Typora),以下是完整梳理:
一、基础语法(通用)
1. 标题
用于定义文档层级标题,支持 1-6 级,# 数量对应级别,# 与标题文字间需加空格。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2. 段落与换行
- 段落:直接输入文字,段落间空一行即可分隔。
- 换行:行尾加 2 个空格 后按回车,或用
<br>标签。
这是第一个段落,
行尾加两个空格(此处有两个空格)
可以实现换行。
这是第二个段落(与上一段空一行分隔)。
这是强制换行<br>使用 br 标签的效果。
效果:
这是第一个段落,
行尾加两个空格(此处有两个空格)
可以实现换行。
这是第二个段落(与上一段空一行分隔)。
这是强制换行
使用 br 标签的效果。
3. 文本格式
| 语法 | 示例 | 效果 |
|---|---|---|
| 加粗 | **加粗文字** 或 __加粗文字__ |
加粗文字 |
| 斜体 | *斜体文字* 或 _斜体文字_ |
斜体文字 |
| 加粗+斜体 | ***加粗斜体*** 或 ___加粗斜体___ |
加粗斜体 |
| 删除线 | ~~删除线文字~~ |
~~删除线文字~~ |
| 下划线 | <u>下划线文字</u>(MD 无原生语法,用 HTML 标签) |
下划线文字 |
| 高亮 | <mark>高亮文字</mark>(扩展语法,部分平台支持) |
高亮文字 |
| 上标 | X^2^(扩展语法) |
X^2^ |
| 下标 | H~2~O(扩展语法) |
H~2~O |
4. 列表
(1)无序列表
用 -、+、* 开头,符号与文字间加空格,可嵌套(缩进 2/4 个空格)。
- 无序列表项 1
- 嵌套项 1-1
- 嵌套项 1-2
* 无序列表项 2
- 无序列表项 3
效果:
- 无序列表项 1
- 嵌套项 1-1
-
嵌套项 1-2
-
无序列表项 2
-
无序列表项 3
(2)有序列表
用 数字. 开头,数字顺序不影响显示(编辑器会自动修正),支持嵌套。
1. 有序列表项 1
1. 嵌套项 1-1
2. 嵌套项 1-2
2. 有序列表项 2
3. 有序列表项 3
效果:
- 有序列表项 1
- 嵌套项 1-1
- 嵌套项 1-2
- 有序列表项 2
- 有序列表项 3
(3)任务列表(扩展语法)
用 - [ ] 表示未完成,- [x] 表示已完成。
- [ ] 待办任务 1
- [x] 已完成任务 2
- [ ] 待办任务 3
效果:
- [ ] 待办任务 1
- [x] 已完成任务 2
- [ ] 待办任务 3
5. 链接
(1)行内链接
[链接文字](链接地址 "可选标题")
示例:[GitHub](https://github.com "GitHub官网")
效果:GitHub
(2)参考式链接
适合重复使用同一链接,分“链接标记”和“链接定义”两部分。
[链接文字][标记名]
[标记名]: 链接地址 "可选标题"
示例:
[我的 GitHub][github]
[github]: https://github.com "GitHub"
效果:我的 GitHub
(3)自动链接
直接用 <> 包裹网址/邮箱,自动识别为链接。
<https://www.baidu.com>
<example@mail.com>
效果:https://www.baidu.com、example@mail.com
6. 图片
语法与链接类似,仅多一个 ! 前缀,支持本地图片和网络图片。

示例:

效果:
7. 引用(块引用)
用 > 开头,支持嵌套(多阶 >),可嵌套其他语法(如列表、链接)。
> 一级引用
>
> > 二级嵌套引用
> >
> > > 三级嵌套引用
>
> 引用内可嵌套列表:
>
> - 列表项 1
> - 列表项 2
效果:
一级引用
二级嵌套引用
三级嵌套引用
引用内可嵌套列表:
- 列表项 1
- 列表项 2
8. 代码
(1)行内代码
用 ` 包裹单行代码/变量。
行内代码示例:`print("Hello World")`,变量 `x = 10`。
效果:行内代码示例:print("Hello World"),变量 x = 10。
(2)代码块
用 ``` 包裹多行代码,可指定语言(实现语法高亮),也可用 4 个空格/1 个制表符缩进(老式写法)。
```python
# Python 代码示例
def hello():
print("Hello Markdown")
hello()
```
**效果**:
```python
# Python 代码示例
def hello():
print("Hello Markdown")
hello()
9. 分割线
用 ---、***、___ (至少 3 个字符,无多余字符),单独一行。
---
---
---
效果:
10. 转义字符
用 \ 转义 Markdown 特殊符号(如 #、*、[、] 等)。
\# 这不是标题 \* 这不是斜体
\[链接文字\]\(链接地址\)
效果: # 这不是标题 * 这不是斜体 [链接文字](链接地址)
二、扩展语法(部分平台支持)
1. 表格
用 | 分隔列,- 分隔表头和内容,: 控制对齐(:--- 左对齐、---:右对齐、:---: 居中)。
| 表头 1 | 表头 2 | 表头 3 |
| ------ | ------ | ------ |
| 内容 1 | 内容 2 | 内容 3 |
| 内容 4 | 内容 5 | 内容 6 |
效果:
| 表头 1 | 表头 2 | 表头 3 |
|---|---|---|
| 内容 1 | 内容 2 | 内容 3 |
| 内容 4 | 内容 5 | 内容 6 |
2. 脚注
用 [^标记名] 定义脚注引用,[^标记名]: 脚注内容 定义脚注说明。
这是带脚注的文字[^1]。
[^1]: 这是脚注的具体内容。
效果: 这是带脚注的文字^1。
3. 数学公式(LaTeX)
用 $ 包裹行内公式,$$ 包裹块级公式(需编辑器支持,如 Typora、GitHub)。
行内公式:$E=mc^2$
块级公式:
$$
\sum_{i=1}^n i = \frac{n(n+1)}{2}
$$
效果: 行内公式:$E=mc^2$ 块级公式:
$$ \sum_{i=1}^n i = \frac{n(n+1)}{2} $$
4. 目录(TOC)
用 [TOC] 自动生成文档目录(根据标题层级),部分编辑器支持。
[TOC]
# 一级标题
## 二级标题
效果:会自动生成包含“一级标题”“二级标题”的可点击目录(不同编辑器显示略有差异)。
5. 定义列表
用 术语 + : + 定义内容,部分平台支持。
Markdown
: 轻量级标记语言
HTML
: 超文本标记语言
效果: Markdown : 轻量级标记语言 HTML : 超文本标记语言
总结
- Markdown 核心语法分为基础语法(标题、列表、链接、代码等,所有编辑器通用)和扩展语法(表格、公式、脚注等,需平台/编辑器支持)。
- 特殊符号需用
\转义,行内代码用`包裹,多行代码用 ``` 并指定语言实现高亮。 - 扩展语法中,表格、任务列表、公式是最常用的,不同平台(如 GitHub、Typora、语雀)对扩展语法的支持度略有差异,使用前可先测试。