Markdown 语法指南

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

本文提供了 Hugo 内容文件中可用的基本 Markdown 语法示例,同时展示了 Hugo 主题下基本 HTML 元素的 CSS 样式效果。

标题

以下 HTML <h1><h6> 元素分别代表六级标题。<h1> 为最高级,<h6> 为最低级。

H1

H2

H3

H4

H5
H6

段落

本段为示例段落,用于展示 Markdown 在 Hugo 主题下的段落样式。你可以在这里书写任意内容,支持多行文本和各种格式。

这是第二段内容,用于进一步展示段落的换行和分段效果。

引用块

blockquote 元素用于表示引用自其他来源的内容,可以带有引用来源(需放在 footercite 元素中),也可以包含内联批注或缩写。

无来源的引用

这是一个没有来源的引用示例。 注意:你可以在引用块中使用 Markdown 语法

带来源的引用

不要通过共享内存来通信,要通过通信来共享内存。
Rob Pike1

表格

表格不是 Markdown 的核心规范,但 Hugo 原生支持表格。

姓名 年龄
Bob 27
Alice 23

表格内的 Markdown 语法

斜体 粗体 代码
斜体 粗体 代码
A B C D E F
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus ultricies, sapien non euismod aliquam, dui ligula tincidunt odio, at accumsan nulla sapien eget ex. Proin eleifend dictum ipsum, non euismod ipsum pulvinar et. Vivamus sollicitudin, quam in pulvinar aliquam, metus elit pretium purus Proin sit amet velit nec enim imperdiet vehicula. Ut bibendum vestibulum quam, eu egestas turpis gravida nec Sed scelerisque nec turpis vel viverra. Vivamus vitae pretium sapien

代码块

使用反引号的代码块

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

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

<!doctype html>
<html lang="en">
<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 的演讲。 ↩︎

使用 Hugo 构建
主题 StackJimmy 设计