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.146.0 或更高版本。
Note
即使用户只是浏览内容，也应该知道的有用信息。
Tip
帮助用户更高效或更轻松完成任务的建议。
Important
用户需要了解的关键信息，以实现他们的目标。
Warning
需要用户立即关注的紧急信息，以避免出现问题。
Caution
关于某些操作可能带来风险或负面结果的警告。
Markdown
> [!NOTE]
> 即使用户只是浏览内容，也应该知道的有用信息。
> [!TIP]
> 帮助用户更高效或更轻松完成任务的建议。
> [!IMPORTANT]
> 用户需要了解的关键信息，以实现他们的目标。
> [!WARNING]
> 需要用户立即关注的紧急信息，以避免出现问题。
> [!CAUTION]
> 关于某些操作可能带来风险或负面结果的警告。表格
表格不是 Markdown 核心规范的一部分，但 Hugo 原生支持它们。
| 姓名 | 年龄 |
|---|---|
| 张三 | 27 |
| 李四 | 23 |
Markdown
| 姓名 | 年龄 |
| :--- | :--- |
| 张三 | 27 |
| 李四 | 23 |表格内的行内 Markdown
| 斜体 | 粗体 | 代码 |
|---|---|---|
| 斜体 | 粗体 | 代码 |
Markdown
| 斜体 | 粗体 | 代码 |
| :----- | :------- | :----- |
| _斜体_ | **粗体** | `代码` |代码块
列表
有序列表
- 第一项
- 第二项
- 第三项
Markdown
1. 第一项
2. 第二项
3. 第三项无序列表
- 列表项
- 另一个项
- 再一个项
Markdown
- 列表项
- 另一个项
- 再一个项嵌套列表
- 水果
- 苹果
- 橙子
- 香蕉
- 乳制品
- 牛奶
- 奶酪
Markdown
- 水果
- 苹果
- 橙子
- 香蕉
- 乳制品
- 牛奶
- 奶酪图片
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。
学习资源
最后更新于