Markdown 基础语法速查

Markdown 是一种轻量级标记语言，通过简单的符号标记实现文本排版，语法简洁易记，无需复杂操作即可生成规整的格式，广泛用于文档、笔记、博客等场景，纯文本编写，跨平台兼容。

一、标题

用 # 表示，# 数量对应标题级别（1-6 级），# 与标题文字之间需加一个空格，级别越高字体越大。

markdown 复制代码

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

建议：文档中一级标题仅用 1 个（作为总标题），二级标题作为大板块，依次层级递进，保证结构清晰。

二、段落与换行

段落：直接输入文字，两个回车表示新段落（会自动留空行）；

强制换行：一行文字末尾加两个空格，再回车，实现同段落内换行（无空行）。

markdown 复制代码

这是第一个段落，直接编写即可。
（两个回车）
这是第二个段落，与上一段有空白行。

这是同一段落的第一行。（两个空格+回车）
这是同一段落的第二行，无空白行衔接。

三、字体样式

常用四种基础样式，符号与文字之间无空格，可组合使用（如下划线 + 粗体）。

markdown 复制代码

**粗体**：文字前后加2个*或2个_
*斜体*：文字前后加1个*或1个_
***粗斜体***：文字前后加3个*或3个_
~~删除线~~：文字前后加2个~
<u>下划线</u>：用HTML标签<u></u>（Markdown原生无下划线语法）

四、引用

用 > 表示，支持多层嵌套（多个 >），引用内可嵌套其他语法（如字体、列表）。

markdown 复制代码

> 一级引用
>> 二级引用
>>> 三级引用
> **引用内的粗体**
> *引用内的斜体*

效果：

一级引用

二级引用

三级引用
引用内的粗体
引用内的斜体

五、列表

分无序列表、有序列表，支持嵌套（列表内嵌套列表、引用、代码块等），嵌套时需缩进 4 个空格或 1 个 Tab。

1. 无序列表

用 *、+、- 表示，符号与文字之间加一个空格，三种符号效果一致，可混用。

markdown 复制代码

* 无序列表项1
+ 无序列表项2
- 无序列表项3
  - 嵌套无序列表项（缩进4个空格）
    * 二级嵌套

效果：

无序列表项1

无序列表项2

无序列表项3
- 嵌套无序列表项（缩进4个空格）
  - 二级嵌套

2. 有序列表

用「数字 +.」表示，数字可任意（渲染后会自动按顺序排列），. 与文字之间加一个空格。

markdown 复制代码

1. 有序列表项1
2. 有序列表项2
3. 有序列表项3
  1. 嵌套有序列表项（缩进4个空格）
    2. 二级嵌套

效果：

有序列表项1
有序列表项2
有序列表项3
1. 嵌套有序列表项（缩进4个空格）
2. 二级嵌套

六、代码块

分行内代码和块级代码，用于展示代码、命令、关键符号，避免被 Markdown 解析。

行内代码
用 `（反引号，键盘 Tab 键上方）包裹，嵌入段落中。

markdown 复制代码

行内代码示例：`print("Hello Markdown")`，Python中用`#`表示注释。

效果：行内代码示例：print("Hello Markdown")，Python 中用#表示注释。

块级代码
用三个反引号包裹，单独成块，可指定语言（如python、java、html），实现语法高亮，上下的需单独占行。

markdown 复制代码

```python
# Python代码示例
def hello():
    print("Hello Markdown!")
hello()

效果：

python 复制代码

# Python代码示例
def hello():
    print("Hello Markdown!")
hello()

七、链接

分行内式链接 、参考式链接 、自动链接，适用于跳转网页、文档、图片等。

1. 行内式（最常用）

格式：[链接文字](链接地址 "链接标题")，"链接标题" 可选，鼠标悬停在链接上时显示。

markdown 复制代码

[百度](https://www.baidu.com "全球最大搜索引擎")
[我的笔记](./note.md "本地笔记文档")

效果：
百度

2. 参考式

先定义链接标识，再在需要的地方引用，适合同一链接多次使用的场景，标识可自定义（数字、字母、文字）。

markdown 复制代码

// 定义链接（可放在文档任意位置，一般在末尾）
[1]: https://www.github.com "GitHub官网"
[2]: ./image.jpg "本地图片"

// 引用链接
GitHub官网：[点击访问][1]
本地图片：[查看][2]

效果：

GitHub官网：点击访问

本地图片：查看

3. 自动链接

直接用 <> 包裹网址 / 邮箱，会自动渲染为可点击的链接。

markdown 复制代码

<https://www.csdn.net>
<123456@qq.com>

效果：https://www.csdn.net 、123456@qq.com

八、图片

与链接语法相似，仅在前面加一个！，格式：[图片替代文字]（图片地址 "图片标题"）

图片替代文字：图片加载失败时显示的文字，必填；
图片地址：可填网络图片 URL或本地图片路径（相对路径 / 绝对路径）；
图片标题：可选，鼠标悬停显示。

bash 复制代码

// 网络图片
![Markdown图标](https://img-blog.csdnimg.cn/xxx.png "Markdown Logo")
// 本地图片（相对路径，图片与md文档同目录）
![本地图片](./test.jpg "测试图片")
// 本地图片（绝对路径，Windows示例）
![绝对路径图片](C:/Users/xxx/Desktop/photo.png)

效果：

// 网络图片

// 本地图片（相对路径，图片与md文档同目录）

// 本地图片（绝对路径，Windows示例）

注意：Markdown 本身不支持调整图片大小，如需调整，可使用 HTML 的标签：。

九、分割线

用 ***、---、___ 表示，单独占行，前后无其他文字，符号数量至少 3 个，可连续写（如----），效果一致。

这是分割线上方的内容

这是分割线下方的内容

另一条分割线

十、表格

Markdown 表格为简易表格，支持左对齐、右对齐、居中对齐，第一行为表头，第二行为对齐方式分隔线，第三行开始为内容，| 分隔列，- 表示分隔线，列之间的空格不影响渲染。

格式：

markdown 复制代码

| 表头1 | 表头2 | 表头3 |
| :---- | :---: | ----: |
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |

效果：

表头1	表头2	表头3
内容1	内容2	内容3
内容4	内容5	内容6

:----：左对齐（默认）
:---:：居中对齐
----:：右对齐
注意：第二行的-数量至少 1 个，与表头列数一致。

十一、转义字符

当需要显示 Markdown 语法符号（如#、*、|）本身，而非其语法效果时，在符号前加 ** 反斜杠 ** 进行转义。

markdown 复制代码

\# 这不是一级标题
\* 这不是斜体
\| 这是竖线本身

效果；

这不是一级标题

* 这不是斜体

| 这是竖线本身

十二、常用拓展语法（部分编辑器支持）

以上为 Markdown原生基础语法，不同编辑器（如 Typora、VS Code、语雀）会支持拓展语法，常用的有：

任务列表
用 - [ ]（未完成）、- [x]（已完成）表示，中括号内的空格 /× 为关键，与文字之间加空格。

markdown 复制代码

- [ ] 学习Markdown基础语法
- [x] 掌握标题和字体样式
- [ ] 练习表格和代码块

效果：

学习Markdown基础语法
掌握标题和字体样式
练习表格和代码块

markdown基本语法

Markdown 基础语法速查

一、标题

二、段落与换行

三、字体样式

四、引用

五、列表

六、代码块

七、链接

1. 行内式（最常用）

2. 参考式

3. 自动链接

八、图片

九、分割线

十、表格

十一、转义字符

这不是一级标题

十二、常用拓展语法（部分编辑器支持）