Markdown 语法指南

May 11, 2026 · 6 mins read

Markdown 是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML。Markdown 的设计哲学是“易读性”，它使得文本内容在原始状态下就足够清晰，并且可以很容易地被转换为其他格式。在 Hugo 中，Markdown 是创建内容的主要方式，掌握其基本语法对于高效使用 Hugo 至关重要。

1. 标题 (Headings)

标题使用 # 符号来表示，# 的数量决定了标题的级别，从一级标题到六级标题。

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

2. 段落 (Paragraphs)

段落就是您输入的普通文本。段落之间需要一个空行来分隔。

3. 强调 (Emphasis)

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

4. 列表 (Lists)

无序列表 (Unordered Lists): 使用星号 *、加号 + 或减号 - 作为列表标记。

* 项目一
* 项目二
  * 子项目二点一
  * 子项目二点二
- 项目三

有序列表 (Ordered Lists): 使用数字后跟一个点 .。

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

5. 链接 (Links)

Markdown 的链接语法非常灵活。

行内链接 (Inline Links):

这是一个 [行内链接](http://example.com "链接标题")。

参考式链接 (Reference-style Links): 这种方式可以将链接定义部分与链接文本分开，使内容更整洁。

我经常访问 [Google][1] 和 [Hugo 官网][hugo]。

[1]: http://google.com "Google 搜索"
[hugo]: https://gohugo.io/ "Hugo 官方网站"

6. 图片 (Images)

图片语法与链接非常相似，只是前面多了一个感叹号 !。

行内图片:

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

参考式图片:

![Hugo Logo][logo]

[logo]: https://gohugo.io/img/hugo-logo.png "Hugo Logo"

7. 代码 (Code)

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

在 Markdown 中，可以使用 `` `code` `` 来表示行内代码。

代码块 (Code Blocks): 使用三个反引号 ``` 包裹代码块，还可以指定语言用于语法高亮。

```html
<!DOCTYPE html>
<html>
<body>
    <h1>我的第一个标题</h1>
    <p>我的第一个段落。</p>
</body>
</html>

8. 引用 (Blockquotes)

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

> 这是引用的内容。
>
> > 这是一个嵌套的引用。

9. 分隔线 (Horizontal Rules)

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

---
***
___

10. 表格 (Tables)

Markdown 支持表格，但语法相对复杂一些。使用管道符 | 分隔列，使用连字符 - 分隔表头和表体。冒号 : 用于对齐。

| 列头 1 | 列头 2 | 列头 3 |
| :------ | :----: | -----: |
| 左对齐 | 居中对齐 | 右对齐 |
| 文本1 | 文本2 | 文本3 |

11. 删除线 (Strikethrough)

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

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

12. HTML 标签

Markdown 允许你直接在文档中使用 HTML 标签。这对于需要更精细控制布局或嵌入特定 HTML 元素的情况非常有用。

总结

掌握这些 Markdown 语法，您就可以在 Hugo 中轻松创建结构清晰、格式丰富的网页内容了。Markdown 的简洁性使得写作过程更加流畅，而 Hugo 的强大功能则能将这些文本转化为精美的网站。