Markdown 语法指南

Thu, 07 Sep 2023 00:00:00 +0000

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

标题

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

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

段落

Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.

Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.

引用块

blockquote 元素代表引自其他来源的内容，可选择性地附上引用来源（该来源必须位于 footer 或 cite 元素中），也可以包含行内的注释与缩写等修改。

无来源署名的引用

Tiam, ad mint andaepu dandae nostion secatur sequo quae. 注意你可以在引用块内使用 Markdown 语法。

附有来源的引用

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

表格

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

姓名	年龄
Bob	27
Alice	23

表格内的行内 Markdown

斜体	粗体	代码
italics	bold	`code`

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>Example HTML5 Document</title>
</head>
<body>
 <p>Test</p>
</body>
</html>

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

<!doctype html>
<html lang="en">
<head>
 <meta charset="utf-8">
 <title>Example HTML5 Document</title>
</head>
<body>
 <p>Test</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>A paragraph</p>

列表类型

有序列表

第一项
第二项
第三项

无序列表

列表项
另一项
再一项

嵌套列表

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

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

GIF 是一种位图图像格式。

H₂O

Xⁿ + Yⁿ = Zⁿ

按 CTRL + ALT + Delete 结束会话。

大多数蝾螈是夜行性动物，捕食昆虫、蠕虫及其他小型生物。

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

主题 on 海上共明月