基本语法

约 1587 字大约 5 分钟

2025-06-19

标题

在想要设置为标题的文字前面加 # 来表示。一个 # 是一级标题，两个 # 是二级标题，以此类推，支持六级标题，对应 HTML 标签 <h1> ~ <h6>。

注：标准语法一般在 # 后跟一个空格再写文字。

示例：

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

除此之外，Markdown 还支持 Setext 风格的标题，使用下划线来标识一级和二级标题：

这是一级标题
===

这是二级标题
---

注意：Setext 风格仅支持一级和二级标题，在 GitHub 开源项目中较为常见。

段落

段落之间用一个或多个空行分隔，生成的 HTML 会自动包裹在 <p> 标签中。

字体

斜体

用单个 * 或 _ 包裹文字：

*这是倾斜的文字*
_这是倾斜的文字_

效果：这是倾斜的文字，这是倾斜的文字

加粗

用两个 * 或 _ 包裹文字：

**这是加粗的文字**
__这是加粗的文字__

效果：这是加粗的文字，这是加粗的文字

斜体加粗

用三个 * 或 _ 包裹文字：

***这是斜体加粗的文字***
___这是斜体加粗的文字___

效果：这是斜体加粗的文字，这是斜体加粗的文字

删除线

用两个 ~~ 包裹文字：

~~这是被删除的文字~~

效果：~~这是被删除的文字~~

下划线

Markdown 原生不支持下划线，可通过 HTML 标签实现：

<u>带下划线的文本</u>

效果：带下划线的文本

换行

在大多数 Markdown 解析器中，直接换行不会产生新段落。如需强制换行，可以在行尾添加两个空格，或使用 <br> 标签：

第一行  
第二行

效果：

第一行
第二行

列表

无序列表

使用 -、+ 或 * 作为列表标记，标记与内容之间必须有空格：

- 列表内容 A
+ 列表内容 B
* 列表内容 C

效果：

列表内容 A

列表内容 B

列表内容 C

有序列表

使用数字加点，数字与内容之间必须有空格：

1. 第一项
2. 第二项
3. 第三项

效果：

第一项
第二项
第三项

有趣的事实：Markdown 的有序列表只关心第一个编号，后续编号可以随意填写，解析器会自动按顺序递增。

列表嵌套

上一级和下一级之间使用 三个空格 缩进即可：

- 一级无序列表内容
   - 二级无序列表内容 A
   - 二级无序列表内容 B

- 一级无序列表内容
   1. 二级有序列表内容 A
   2. 二级有序列表内容 B

1. 一级有序列表内容
   - 二级无序列表内容 A
   - 二级无序列表内容 B

1. 一级有序列表内容
   1. 二级有序列表内容 A
   2. 二级有序列表内容 B

效果：

一级无序列表内容
- 二级无序列表内容 A
- 二级无序列表内容 B
一级无序列表内容
1. 二级有序列表内容 A
2. 二级有序列表内容 B

一级有序列表内容
- 二级无序列表内容 A
- 二级无序列表内容 B
一级有序列表内容
1. 二级有序列表内容 A
2. 二级有序列表内容 B

区块

引用

在文字前加 > 即可创建引用块，支持多层嵌套：

> 这是引用的内容
>> 这是嵌套引用
>>> 这是三层嵌套引用

效果：

这是引用的内容
这是嵌套引用
这是三层嵌套引用

区块中使用列表

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 无序项 A
> + 无序项 B

效果：

区块中使用列表
第一项
第二项
无序项 A
无序项 B

列表中使用区块

如果要在列表项目内放入区块，需要在 > 前添加四个空格或一个 tab：

* 第一项
    > Markdown教程
    > 学的不仅是技术，更是梦想
* 第二项

效果：

第一项
Markdown教程学的不仅是技术，更是梦想
第二项

表格

表格使用 | 分隔列，使用 - 分隔表头与内容：

姓名 | 技能 | 排行
--- | :---: | ---:
刘备 | 哭 | 大哥
关羽 | 打 | 二哥
张飞 | 骂 | 三弟

效果：

姓名	技能	排行
刘备	哭	大哥
关羽	打	二哥
张飞	骂	三弟

对齐规则：
默认居左：---
居中：:---:
居右：---:

代码

行内代码

用单个反引号 ` 包裹代码：

运行 `npm install` 安装依赖

效果：运行 npm install 安装依赖

代码块

用三个反引号 ``` 包裹代码块，可在开头指定编程语言以实现语法高亮：

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

hello()
```

效果：

def hello():
    print("Hello, World!")

hello()

注意：如果代码块内部包含反引号，可以使用更多反引号来包裹（如 ````` ）。

分割线

使用三个或更多 -、* 或 _（可以混合使用），前后各留一个空行：

---

***

_____

效果：

图片

语法：

![图片替代文本](图片地址 "可选标题")

替代文本（alt）：图片无法加载时显示的文字，也用于无障碍访问
标题（title）：鼠标悬停在图片上时显示的提示文字，可省略

示例：

![区块链](https://example.com/blockchain.jpg "区块链")

效果：

超链接

语法：

[链接文本](URL "可选标题")

示例：

[百度](https://www.baidu.com "百度搜索")

效果：百度

自动链接

用 < 和 > 包裹 URL 或邮箱地址，Markdown 会自动将其转换为可点击链接：

<https://www.baidu.com>
<example@email.com>

效果：

https://www.baidu.com example@email.com

参考链接

除了行内链接外，Markdown 还支持参考式链接，适合链接地址较长或需要复用的场景：

这是 [GitHub][1] 和 [百度][2] 的链接。

[1]: https://www.github.com "GitHub 官网"
[2]: https://www.baidu.com "百度搜索"

效果：这是 GitHub 和百度的链接。

注释

使用 HTML 注释语法：

<!-- 这是一段注释，不会在渲染结果中显示 -->