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 核心规范的一部分，但 Hugo 原生支持它们。
| 姓名 | 年龄 |
|---|---|
| 张三 | 27 |
| 李四 | 23 |
Markdown
| 姓名 | 年龄 |
| :--- | :--- |
| 张三 | 27 |
| 李四 | 23 |表格内的行内 Markdown
| 斜体 | 粗体 | 代码 |
|---|---|---|
| 斜体 | 粗体 | 代码 |
Markdown
| 斜体 | 粗体 | 代码 |
| :----- | :------- | :----- |
| _斜体_ | **粗体** | `代码` |代码块
列表
有序列表
- 第一项
- 第二项
- 第三项
Markdown
1. 第一项
2. 第二项
3. 第三项无序列表
- 列表项
- 另一个项
- 再一个项
Markdown
- 列表项
- 另一个项
- 再一个项嵌套列表
- 水果
- 苹果
- 橙子
- 香蕉
- 乳制品
- 牛奶
- 奶酪
Markdown
- 水果
- 苹果
- 橙子
- 香蕉
- 乳制品
- 牛奶
- 奶酪任务列表
- 编写文档
- 代码审查
- 部署更改
Markdown
- [x] 编写文档
- [ ] 代码审查
- [ ] 部署更改图片
Markdown
带标题：
Markdown
如需更高级的功能，请使用 Hugo 内置的 Figure 短代码。
配置
Hugo 使用 Goldmark 进行 Markdown 解析。
Markdown 渲染可以在 hugo.yaml 中的 markup.goldmark 下配置。
以下是 Hextra 的默认配置：
hugo.yaml
markup:
goldmark:
renderer:
unsafe: true
highlight:
noClasses: false更多配置选项，请参阅 Hugo 文档中的 配置 Markup。