本文提供了可在 Hugo 内容文件中使用的基本 Markdown 语法示例，同时展示了 Hugo 主题中基本 HTML 元素是否使用 CSS 进行装饰。

标题

以下 HTML <h1>—<h6> 元素代表六个级别的章节标题。<h1> 是最高级别的章节标题，而 <h6> 是最低级别的。

H1

H2

H3

H4

H5

H6

段落

这是一个示例段落，用于展示 Markdown 中的段落格式。您可以在此处添加任何您想要的内容，以测试不同的 Markdown 语法和样式。

这是另一个段落，用来进一步演示段落的使用方式。通过使用空行分隔不同的段落，可以清晰地组织文档结构。

引用块

blockquote 元素表示从其他来源引用的内容，可选择包含必须在 footer 或 cite 元素内的引用，并可选择包含内联更改，如注释和缩写。

无署名的引用块

学而不思则罔，思而不学则殆。注意，您可以在 blockquote 中使用 Markdown 语法。

有署名的引用块

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

表格

表格不是核心 Markdown 规范的一部分，但 Hugo 支持开箱即用的表格。

姓名	年龄
Bob	27
Alice	23

表格中的内联 Markdown

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

A	B	C	D	E	F
	此单元格演示表格中的长文本占位效果，用于展示表格布局能力	此处展示复杂内容排版，包含多元素混合布局的测试文本	表格单元格宽度自适应演示内容	验证长文本在有限列宽下的显示效果	表格样式兼容性测试文本

代码块

使用反引号的代码块

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>HTML5 示例文档</title>
</head>
<body>
  <p>测试段落</p>
</body>
</html>

使用四个空格缩进的代码块

<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>HTML5 示例文档</title>
</head>
<body>
  <p>测试段落</p>
</body>
</html>

Diff 代码块

1
2
3
4
5
[dependencies.bevy]
git = "https://github.com/bevyengine/bevy"
rev = "11f52b8c72fc3a568e8bb4a4cd1f3eb025ac2e13"
- features = ["dynamic"]
+ features = ["jpeg", "dynamic"]

单行代码块

1
<p>一个段落</p>

列表类型

有序列表

第一项
第二项
第三项

无序列表

列表项
另一个项
再一个项

嵌套列表

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

其他元素 — abbr, sub, sup, kbd, mark

GIF 是一种位图图像格式。

H₂O

Xⁿ + Yⁿ = Zⁿ

按 CTRL + ALT + Delete 结束会话。

大多数蝾螈是夜间活动的，捕食昆虫、蠕虫和其他小生物。

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

Markdown 语法指南

展示基本 Markdown 语法和 HTML 元素格式化的示例文章。

标题

H1

H2

H3

H4

H5

H6

段落

引用块