博客 Markdown 功能测试
2026-03-15
本博客使用基于 pulldown-cmark 的 Markdown 渲染器。本渲染器支持 CommonMark 标准，并额外启用了多种实用扩展，帮助你编写更丰富、更具表现力的文档。下文将逐一介绍基础语法与各项扩展功能的使用方法。
基础功能
标题
使用 # 表示标题，支持六级：
源代码：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
段落与换行
段落之间用一个空行分隔。行尾加两个空格可强制换行。
源代码：
这是第一段。
这是第一段的下一行（行尾有两个空格）。
这是第二段。
渲染效果：
这是第一段。
这是第一段的下一行（行尾有两个空格）。
这是第二段。
强调
源代码：
*斜体* 或 _斜体_
**粗体** 或 __粗体__
***粗斜体*** 或 ___粗斜体___
渲染效果：
斜体 或 斜体
粗体 或 粗体
粗斜体 或 粗斜体
列表
无序列表
源代码：
- 项目一
- 项目二
- 嵌套项目
渲染效果：
- 项目一
- 项目二
- 嵌套项目
有序列表
源代码：
1. 第一项
2. 第二项
1. 嵌套第一项
渲染效果：
- 第一项
- 第二项
- 嵌套第一项
块引用
源代码：
> 这是一段引用。
> 可以跨多行。
>
> 甚至包含其他元素，如 **强调**。
渲染效果：
这是一段引用。 可以跨多行。
甚至包含其他元素，如 强调。
代码
源代码：
- 行内代码：`printf("hello world");`
- 代码块（通过缩进或围栏式）：
```rust
fn main() {
println!("Hello, world!");
}
```
渲染效果：
- 行内代码：
printf("hello world"); - 代码块：
fn main() {
println!("Hello, world!");
}
分隔线
三个或更多 -、* 或 _：
源代码：
---
渲染效果：
链接
源代码：
[行内链接](https://example.com)
[引用链接][1]
[1]: https://example.com
渲染效果：
图片
源代码：
渲染效果：
若图片不存在，则显示替代文本。
扩展功能
本渲染器通过配置选项启用了以下扩展，请根据需要使用相应语法。
表格
使用竖线 | 和短横 - 创建表格，支持对齐方式。
源代码：
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 单元格 | 单元格 | 单元格 |
| 内容 | 内容 | 内容 |
渲染效果：
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 单元格 | 单元格 | 单元格 |
| 内容 | 内容 | 内容 |
删除线
用两个波浪线 ~~ 包围文本表示删除线。
源代码：
~~这是一段被删除的文字。~~
渲染效果：
这是一段被删除的文字。
任务列表
在列表项中使用 [ ] 或 [x] 创建待办事项。
源代码：
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 嵌套子任务
渲染效果：
- 已完成任务
-
未完成任务
- 嵌套子任务
定义列表
使用以下语法创建定义列表：
源代码：
术语一
: 定义一
术语二
: 定义二的第一段
: 定义二的第二段
渲染效果：
- 术语一
- 定义一
- 术语二
- 定义二的第一段
- 定义二的第二段
脚注
使用 [^标识] 标记脚注引用，并在文末定义脚注内容。
源代码：
这是一段包含脚注的文本[^1]。
[^1]: 这是脚注内容，可以包含多段文字，甚至其他 Markdown 元素如 *强调*。
渲染效果：
这是一段包含脚注的文本1。
这是脚注内容，可以包含多段文字，甚至其他 Markdown 元素如 强调。
GFM 引用块
引入了多个 GitHub Flavored Markdown 引用块。
> [!NOTE]
> 这里是笔记内容。
渲染效果：
这里是笔记内容。
> [!TIP]
> 这里用于给予读者提示。
渲染效果：
这里用于给予读者提示。
> [!IMPORTANT]
> 这里是行文中的重点。
渲染效果：
这里是行文中的重点。
> [!WARNING]
> 这里需要引起读者注意。
渲染效果：
这里需要引起读者注意。
> [!CAUTION]
> 这里的内容需要读者万分小心。
渲染效果：
这里的内容需要读者万分小心。
数学公式
使用 $ 包裹行内公式，或使用 $$ 包裹块级公式（LaTeX 语法）。具体渲染工作由 MathJax 完成。
源代码：
行内公式：$E = mc^2$
带标签的块级公式：
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} \tag{1.2}
$$
渲染效果：
行内公式：E = mc^2
带标签的块级公式： \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} \tag{1.2}
标题属性
在标题行末尾添加 { .class } 形式的属性，可用于自定义标题样式。
目前可用类名有 note-label tip-label important-label warning-label caution-label。
源代码：
#### 这是一个提示性标题 { .tip-label }
#### 这是一个警示性标题 { .warning-label }
渲染效果：
这是一个提示性标题
这是一个警示性标题
Wiki 风格链接
使用双中括号 [[链接]] 表示 Wiki 风格链接。
源代码：
[[https://example.com]]
[[https://example.com|这是链接显示的文字]]
渲染效果：