hextra_mirror/markdown.zh-cn.md at d35a471e7bc0fe20f9a525c2880546b0bd6ab282

drowl87/hextra_mirror

Fork 1

mirror of https://github.com/imfing/hextra.git synced 2025-08-23 06:26:44 -04:00

Files

Xin f79b1d262c chore: update zh-cn translation

2025-08-14 19:07:25 +08:00

5.0 KiB

Raw Blame History

title, weight

title	weight
Markdown	2

Hugo 支持使用 Markdown 语法来格式化文本、创建列表等。本页将展示一些最常用的 Markdown 语法示例。

Markdown 示例

文本样式

样式	语法	示例	输出
粗体	`粗体文本`	`粗体文本`	粗体文本
斜体	`斜体文本`	`斜体文本`	斜体文本
删除线	`~~删除线文本~~`	`~~删除线文本~~`	~~删除线文本~~
下标	`<sub></sub>`	`这是<sub>下标</sub>文本`	这是_下标文本
上标	`<sup></sup>`	`这是<sup>上标</sup>文本`	这是^上标文本

引用块

带出处的引用

不要通过共享内存来通信，而要通过通信来共享内存。
— Rob Pike¹

> 不要通过共享内存来通信，而要通过通信来共享内存。<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

关于某些操作可能带来风险或负面结果的警告。

> [!NOTE]
> 即使用户只是浏览内容，也应该知道的有用信息。

> [!TIP]
> 帮助用户更高效或更轻松完成任务的建议。

> [!IMPORTANT]
> 用户需要了解的关键信息，以实现他们的目标。

> [!WARNING]
> 需要用户立即关注的紧急信息，以避免出现问题。

> [!CAUTION]
> 关于某些操作可能带来风险或负面结果的警告。

表格

表格不是 Markdown 核心规范的一部分，但 Hugo 原生支持它们。

姓名	年龄
张三	27
李四	23

| 姓名 | 年龄 |
| :--- | :--- |
| 张三 | 27   |
| 李四 | 23   |

表格内的行内 Markdown

斜体	粗体	代码
斜体	粗体	`代码`

| 斜体   | 粗体     | 代码   |
| :----- | :------- | :----- |
| _斜体_ | **粗体** | `代码` |

代码块

{{< cards >}} {{< card link="../../guide/syntax-highlighting" title="语法高亮" icon="sparkles" >}} {{< /cards >}}

列表

有序列表

第一项
第二项
第三项

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

无序列表

列表项
另一个项
再一个项

- 列表项
- 另一个项
- 再一个项

嵌套列表

水果
- 苹果
- 橙子
- 香蕉
乳制品
- 牛奶
- 奶酪

- 水果
  - 苹果
  - 橙子
  - 香蕉
- 乳制品
  - 牛奶
  - 奶酪

图片

![风景](https://picsum.photos/800/600)

带标题：

![风景](https://picsum.photos/800/600 "Lorem Picsum")

如需更高级的功能，请使用 Hugo 内置的 Figure 短代码。

配置

Hugo 使用 Goldmark 进行 Markdown 解析。 Markdown 渲染可以在 hugo.yaml 中的 markup.goldmark 下配置。以下是 Hextra 的默认配置：

markup:
  goldmark:
    renderer:
      unsafe: true
  highlight:
    noClasses: false

更多配置选项，请参阅 Hugo 文档中的配置 Markup。

学习资源

上述引用摘自 Rob Pike 在 2015 年 11 月 18 日 Gopherfest 上的演讲。 ↩︎

5.0 KiB Raw Blame History