Markdown 语法指南

May 14, 2026 · 7 mins read

Markdown 是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML。这种简洁的语法使得 Markdown 在技术文档、博客文章、笔记应用等领域得到了广泛应用，尤其是在 Hugo 这样的静态网站生成器中。

本指南将详细介绍 Markdown 的常用语法，帮助你更高效地创建结构清晰、格式丰富的网页内容。

Markdown 使用井号 # 来创建标题，井号的数量表示标题的级别，最多支持六级标题。

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

Markdown 中的段落是通过空行来分隔的。连续的文本行会被合并成一个段落。

这是一个段落。

这是另一个段落。

你可以使用星号 * 或下划线 _ 来强调文本。

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

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

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

有序列表 (Ordered Lists): 使用数字加英文句号来创建。

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

Markdown 链接有两种形式：行内链接和参考链接。

行内链接 (Inline Links):
```
这是一个 [行内链接](https://www.example.com "链接标题")。
```
链接标题 是可选的，当鼠标悬停在链接上时会显示。
参考链接 (Reference Links):
```
我需要一个 [参考链接][ref]。

[ref]: https://www.example.com "链接标题"
```
这种方式在需要多次引用同一链接时非常有用。

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

![图片替代文本](图片URL "图片标题")

例如：

![Hugo Logo](/images/hugo-logo.png "Hugo 官方 Logo")

行内代码 (Inline Code): 使用反引号 ` 包裹代码。
```
在文本中插入 `console.log('Hello, Hugo!');`。
```
代码块 (Code Blocks): 使用三个反引号 ``` 来包裹多行代码。你还可以指定语言，以便进行语法高亮。
```
```javascript
function greet(name) {
  console.log('Hello, ' + name + '!');
}
greet('Markdown');
```

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

> 这是引用文本。
>
> 引用块可以包含多个段落。
>
> * 列表也可以在引用块中使用。

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

---
***
___

Markdown 支持创建表格，使用竖线 | 和短横线 - 来分隔列和行。冒号 : 用于对齐文本。

| 表头一 | 表头二 | 表头三 |
| :---- | :----: | ----: |
| 左对齐 | 居中对齐 | 右对齐 |
| 内容A | 内容B | 内容C |
| 内容D | 内容E | 内容F |

使用两个波浪号 ~~ 来创建删除线。

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

在 GitHub Flavored Markdown (GFM) 中，可以使用方括号 [] 来创建任务列表，方括号内可为空格或 x。

- [x] 已完成的任务
- [ ] 未完成的任务
- [x] 另一个已完成的任务

Markdown 允许直接嵌入 HTML 标签，这使得你可以利用 HTML 的所有功能来增强内容。

<p>这是一个<strong>HTML段落</strong>，里面包含 <em>强调</em> 标签。</p>
<abbr title="HyperText Markup Language">HTML</abbr>

掌握以上 Markdown 语法，你就可以轻松地在 Hugo 网站中创建出结构清晰、格式丰富的文章内容了。这门语言的学习曲线非常平缓，但其带来的效率提升却是巨大的。