Themes Syntax

Markdown 语法指南

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

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

标题

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

H1

H2

H3

H4

H5
H6

段落

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

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

引用块

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

无署名的引用块

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

有署名的引用块

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

表格

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

姓名年龄
Bob27
Alice23

表格中的内联 Markdown

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

代码块

使用反引号的代码块

 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>

列表类型

有序列表

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

无序列表

  • 列表项
  • 另一个项
  • 再一个项

嵌套列表

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

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

GIF 是一种位图图像格式。

H2O

Xn + Yn = Zn

按 CTRL + ALT + Delete 结束会话。

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

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