Markdown
Hugo 支持使用 Markdown 语法来格式化文本、创建列表等。本页将展示一些最常见的 Markdown 语法示例。
Markdown 示例
文本样式
| 样式 | 语法 | 示例 | 输出 |
|---|---|---|---|
| 粗体 | **粗体文本** |
**粗体文本** |
粗体文本 |
| 斜体 | *斜体文本* |
*斜体文本* |
斜体文本 |
| 删除线 | ~~删除线文本~~ |
~~删除线文本~~ |
|
| 下标 | <sub></sub> |
这是一个<sub>下标</sub>文本 |
这是一个下标文本 |
| 上标 | <sup></sup> |
这是一个<sup>上标</sup>文本 |
这是一个上标文本 |
引用块
带出处的引用块
不要通过共享内存来通信，而要通过通信来共享内存。
— Rob Pike1
Markdown
> 不要通过共享内存来通信，而要通过通信来共享内存。<br>
> — <cite>Rob Pike[^1]</cite>
[^1]: 以上引用摘自 Rob Pike 在 2015 年 11 月 18 日 Gopherfest 上的[演讲](https://www.youtube.com/watch?v=PAAkCSZUG1c)。提示框
提示框是基于引用块语法的 Markdown 扩展，可用于强调关键信息。 支持 GitHub 风格的提示框。 请确保您使用的是最新版本的 Hextra 和 Hugo v0.134.0 或更高版本。
Note
用户应该知道的有用信息，即使是在浏览内容时。
Tip
帮助用户更好地或更轻松地完成任务的建议。
Important
用户需要了解的关键信息，以实现他们的目标。
Warning
需要用户立即注意的紧急信息，以避免问题。
Caution
关于某些操作的风险或负面结果的建议。
Markdown
> [!NOTE]
> 用户应该知道的有用信息，即使是在浏览内容时。
> [!TIP]
> 帮助用户更好地或更轻松地完成任务的建议。
> [!IMPORTANT]
> 用户需要了解的关键信息，以实现他们的目标。
> [!WARNING]
> 需要用户立即注意的紧急信息，以避免问题。
> [!CAUTION]
> 关于某些操作的风险或负面结果的建议。表格
表格不是 Markdown 核心规范的一部分，但 Hugo 默认支持它们。
| 姓名 | 年龄 |
|---|---|
| Bob | 27 |
| Alice | 23 |
Markdown
| 姓名 | 年龄 |
|--------|------|
| Bob | 27 |
| Alice | 23 |表格中的内联 Markdown
| 斜体 | 粗体 | 代码 |
|---|---|---|
| 斜体 | 粗体 | 代码 |
Markdown
| 斜体 | 粗体 | 代码 |
| -------- | -------- | ------ |
| *斜体* | **粗体** | `代码` |代码块
列表
有序列表
- 第一项
- 第二项
- 第三项
Markdown
1. 第一项
2. 第二项
3. 第三项无序列表
- 列表项
- 另一个项
- 再一个项
Markdown
* 列表项
* 另一个项
* 再一个项嵌套列表
- 水果
- 苹果
- 橙子
- 香蕉
- 乳制品
- 牛奶
- 奶酪
Markdown
* 水果
* 苹果
* 橙子
* 香蕉
* 乳制品
* 牛奶
* 奶酪图片
Markdown
带标题：
Markdown
配置
Hugo 使用 Goldmark 进行 Markdown 解析。
Markdown 渲染可以在 hugo.yaml 中的 markup.goldmark 下进行配置。
以下是 Hextra 的默认配置：
hugo.yaml
markup:
goldmark:
renderer:
unsafe: true
highlight:
noClasses: false更多配置选项，请参阅 Hugo 文档中的 配置 Markup。