Markdown 语法速查与实践

Apr 30, 2026 · 7 mins read

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML。由于其简洁的语法和广泛的适用性，Markdown 已成为博客、技术文档、笔记和在线论坛等领域的事实标准。在 Hugo 这样的静态网站生成器中，Markdown 是内容创作的主要方式。掌握 Markdown 的基本语法，对于高效地构建和维护您的网站至关重要。

1. 标题 (Headings)

使用 # 号来创建标题，# 的数量表示标题的级别，从一级标题到六级标题。

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

2. 段落 (Paragraphs)

段落由一个或多个连续的文本行组成，段落之间用一个或多个空行分隔。

这是第一个段落。

这是第二个段落，它包含更多的文本，展示了段落的延续性。

3. 强调 (Emphasis)

斜体 (Italic): 使用单个星号 * 或下划线 _ 包裹文本。
```
*这是斜体文本*
_这也是斜体文本_
```
粗体 (Bold): 使用两个星号 ** 或下划线 __ 包裹文本。
```
**这是粗体文本**
__这也是粗体文本__
```

粗斜体 (Bold Italic): 结合使用。

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

4. 列表 (Lists)

无序列表 (Unordered Lists): 使用星号 *、加号 + 或减号 - 作为列表标记，并与文本之间留一个空格。
```
* 列表项一
* 列表项二
  * 嵌套列表项
- 列表项三
+ 列表项四
```
有序列表 (Ordered Lists): 使用数字后跟一个点 . 作为列表标记。数字的顺序并不严格要求，Markdown 会自动根据顺序渲染。
```
1. 第一项
2. 第二项
   1. 嵌套的第一项
3. 第三项
```

5. 链接 (Links)

行内链接 (Inline Links):

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

参考链接 (Reference Links):

这是一个 [参考链接][ref] 的例子。
[ref]: https://www.example.com "参考链接标题"

如果链接文本和引用名称相同，可以省略引用名称：

这是一个 [参考链接] 的例子。
[参考链接]: https://www.example.com

6. 图片 (Images)

图片的语法与链接类似，只是在方括号前多一个感叹号 !。

行内图片 (Inline Images):

![图片替代文本](https://www.example.com/image.jpg "图片标题")

参考图片 (Reference Images):

![图片替代文本][img]
[img]: https://www.example.com/image.jpg "图片标题"

7. 代码 (Code)

行内代码 (Inline Code): 使用反引号 ` 包裹。

在文本中插入 `console.log('Hello, Markdown!');` 这样的代码。

代码块 (Code Blocks): 使用三个反引号 `` 包裹，并可以指定语言高亮。
```
```python
def greet(name):
    print(f"Hello, {name}!")

greet("World")
```

8. 引用 (Blockquotes)

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

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

9. 分隔线 (Horizontal Rules)

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

---

10. 表格 (Tables)

表格的语法相对复杂一些，使用竖线 | 和连字符 - 来构建。

| 表头一 | 表头二 | 表头三 |
| :----- | :----: | -----: |
| 左对齐 |  居中  | 右对齐 |
| 文本   |  更多  |  内容  |

: 用于指定对齐方式：左对齐（默认）、居中、右对齐。

11. 删除线 (Strikethrough)

使用两个波浪号 ~~ 包裹。

~~这是被删除的文本~~

12. 任务列表 (Task Lists)

在 Markdown 文件中创建可勾选的待办事项列表。

- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个待办事项

13. 转义字符 (Escaping Characters)

如果您想显示 Markdown 语法本身而不是让它被渲染，可以使用反斜杠 \ 来转义特殊字符。例如，要显示 # 标题，可以写成 \#。

掌握这些 Markdown 语法，将能极大地提高您在 Hugo 平台上创作和编辑内容的速度和效率。多加练习，您会发现 Markdown 是一个强大而优雅的写作工具。