Markdown 语法指南

May 11, 2026 · 7 mins read

Markdown 是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML。Hugo 广泛支持 Markdown，使其成为创建网站内容的首选格式。本指南将全面介绍 Markdown 的常用语法，帮助您更高效地编写 Hugo 内容。

1. 标题 (Headings)

使用 # 号来创建标题，# 的数量代表标题的级别。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2. 段落 (Paragraphs)

段落就是普通文本，用一个或多个空行分隔。

这是第一个段落。

这是第二个段落，它与第一个段落之间有一个空行。

3. 强调 (Emphasis)

4. 列表 (Lists)

无序列表 (Unordered Lists): 使用星号 *、加号 + 或减号 - 开头。
```
* 项目一
* 项目二
  * 子项目 2.1
  * 子项目 2.2
* 项目三
```
结果：
- 项目一
- 项目二
  - 子项目 2.1
  - 子项目 2.2
- 项目三
有序列表 (Ordered Lists): 使用数字加点 1. 开头。
```
1. 第一步
2. 第二步
   1. 细分步骤 2.1
   2. 细分步骤 2.2
3. 第三步
```
结果：
1. 第一步
2. 第二步
  1. 细分步骤 2.1
  2. 细分步骤 2.2
3. 第三步

5. 链接 (Links)

行内链接 (Inline Links): [链接文本](URL "可选的标题")
```
访问 [风驰直播官网](https://www.fengchizhibo.com "风驰直播官方网站") 获取更多信息。
```
结果：访问风驰直播官网获取更多信息。
参考式链接 (Reference-style Links):
```
我经常访问 [Google][1]。
[1]: https://www.google.com "Google 搜索引擎"
```
结果：我经常访问 [Google][1]。 [1]: https://www.google.com “Google 搜索引擎”

6. 图片 (Images)

图片语法与链接类似，只是在开头多一个感叹号 !。

行内图片 (Inline Images): ![替代文本](图片URL "可选的标题")
```
![Hugo Logo](https://gohugo.io/img/hugo-logo.svg "Hugo 标志")
```
结果：
参考式图片 (Reference-style Images):
```
![Hugo Logo][logo]
[logo]: https://gohugo.io/img/hugo-logo.svg "Hugo 标志"
```
结果： ![Hugo Logo][logo] [logo]: https://gohugo.io/img/hugo-logo.svg “Hugo 标志”

7. 代码 (Code)

行内代码 (Inline Code): 使用反引号 ` 包围代码。
```
在 Markdown 中，你可以使用 `code` 来表示行内代码。
```
结果：在 Markdown 中，你可以使用 code 来表示行内代码。

代码块 (Code Blocks): 使用三个反引号包围代码块。可以指定语言以获得语法高亮。

```python
def hello_world():
    print("Hello, Hugo!")

结果：
```python
def hello_world():
    print("Hello, Hugo!")

8. 引用 (Blockquotes)

使用 > 符号来创建引用。

> 这是引用的内容。
> 它可以包含多行。
>> 这是一个嵌套的引用。

结果：

这是引用的内容。它可以包含多行。
这是一个嵌套的引用。

9. 水平分割线 (Horizontal Rules)

使用三个或更多的星号 ***、减号 --- 或下划线 ___ 来创建水平分割线。

---

10. 表格 (Tables)

表格的创建比较直观，使用 | 分隔单元格，使用 - 分隔表头和内容。

| 列标题 1 | 列标题 2 | 列标题 3 |
| :------- | :------: | -------: |
| 左对齐   |  居中对齐  | 右对齐   |
| 单元格A  |  单元格B |  单元格C |

结果：

列标题 1	列标题 2	列标题 3
左对齐	居中对齐	右对齐
单元格A	单元格B	单元格C

11. 删除线 (Strikethrough)

使用两个波浪线 ~~ 包围文本。

~~这是删除线文本~~

结果：~~这是删除线文本~~

12. 有任务列表的复选框 (Task Lists)

在无序列表的基础上，使用 [ ] 或 [x] 来表示未完成或已完成的任务。

* [x] 完成 Hugo 内容编写
* [ ] 添加图片
* [ ] 预览网站

结果：

掌握这些 Markdown 语法，您将能够更灵活、更高效地在 Hugo 中创作和管理您的网站内容，无论是技术文档、博客文章还是其他类型的页面。