Markdown 语法指南

May 6, 2026 · 6 mins read

Markdown 是一种轻量级的标记语言，它的设计理念是以易读易写为目标。通过简单的符号，您可以轻松地为文本添加格式，如标题、列表、粗体、斜体、链接、图片等。Hugo 网站生成器广泛使用 Markdown 来编写内容，因此掌握 Markdown 语法对于 Hugo 用户至关重要。

Markdown 使用 # 号来表示标题的层级。一个 # 表示一级标题，两个 # 表示二级标题，以此类推，最多支持六级标题。

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

段落之间用一个或多个空行分隔。

这是第一个段落。

这是第二个段落。

使用星号 * 或下划线 _ 来创建斜体和粗体文本。

粗斜体 (Bold Italic):

***这是粗斜体***
___这也是粗斜体___

Markdown 支持无序列表和有序列表。

无序列表 (Unordered Lists): 使用星号 *、加号 + 或减号 - 来创建。

* 项目一
* 项目二
  * 子项目 A
  * 子项目 B
- 项目三
+ 项目四

有序列表 (Ordered Lists): 使用数字后跟一个英文句点来创建。

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

Markdown 链接有两种形式：行内链接和引用链接。

行内链接 (Inline Links):

这是一个 [行内链接](https://example.com) 的例子。

引用链接 (Reference Links):

这是一个 [引用链接][ref] 的例子。

[ref]: https://example.com "这是一个可选的标题"

您也可以使用隐式引用，如果引用标签与链接文本相同：

[Google][]

[Google]: https://www.google.com

插入图片的方式与创建链接类似，只是在方括号前多一个感叹号 !。

行内图片 (Inline Images):
```
![图片alt文本](/path/to/image.jpg "图片标题")
```
alt文本 是图片的替代文本，用于在图片无法显示时提供信息，也对 SEO 有益。标题会在鼠标悬停在图片上时显示。

行内代码 (Inline Code): 使用反引号 ` 来包裹行内代码。
```
这是 `行内代码` 的示例。
```
代码块 (Code Blocks): 使用三个反引号 `` 来包裹多行代码块。您还可以指定代码语言，以便进行语法高亮。
```
```python
def hello_world():
    print("Hello, World!")
```
```
console.log("Hello from JavaScript!");
```

使用大于号 > 来创建引用块。

> 这是引用的内容。
>
> 引用块可以包含多个段落。

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

---
***
___

Markdown 支持创建表格，使用竖线 | 和连字符 -。

| 列标题 1 | 列标题 2 | 列标题 3 |
| :------- | :------: | -------: |
| 左对齐   |   居中   |  右对齐  |
| 内容     |   更多   |   数据   |

删除线 (Strikethrough): 使用两个波浪号 ~~ 包裹文本。
```
~~这是删除线文本~~
```
任务列表 (Task Lists): 在列表项中使用 [ ] 或 [x] 来创建可勾选的复选框。
```
- [x] 已完成的任务
- [ ] 未完成的任务
```