跳转至

你想要了解 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
  2. 嵌套项 1-1
  3. 嵌套项 1-2
  4. 有序列表项 2
  5. 有序列表项 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.comexample@mail.com

6. 图片

语法与链接类似,仅多一个 ! 前缀,支持本地图片和网络图片。

![图片替代文字](图片地址 "可选标题")
示例:
![示例图片](https://picsum.photos/200/100 "随机图片")

效果示例图片

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 : 超文本标记语言


总结

  1. Markdown 核心语法分为基础语法(标题、列表、链接、代码等,所有编辑器通用)和扩展语法(表格、公式、脚注等,需平台/编辑器支持)。
  2. 特殊符号需用 \ 转义,行内代码用 ` 包裹,多行代码用 ``` 并指定语言实现高亮。
  3. 扩展语法中,表格、任务列表、公式是最常用的,不同平台(如 GitHub、Typora、语雀)对扩展语法的支持度略有差异,使用前可先测试。

评论