Markdown 语法指南

May 9, 2026 · 7 mins read

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 XHTML（或者HTML）。Markdown 的设计哲学是“内容优先”，让创作者能够专注于文本本身，而无需关心复杂的排版和样式。在 Hugo 这样的静态网站生成器中，Markdown 是最常用的内容编写格式。掌握 Markdown 的基本语法，能够极大地提升您的内容创作效率。

标题 (Headings)

Markdown 使用 # 号来创建标题。# 的数量决定了标题的级别，从一级标题到六级标题。

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

段落 (Paragraphs)

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

强调 (Emphasis)

您可以使用星号 * 或下划线 _ 来创建斜体和粗体。

斜体 (Italic): *斜体* 或 _斜体_ -> 斜体
粗体 (Bold): **粗体** 或 __粗体__ -> 粗体
粗斜体 (Bold Italic): ***粗斜体*** 或 ___粗斜体___ -> 粗斜体

列表 (Lists)

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

无序列表 (Unordered Lists)

使用星号 *、加号 + 或减号 - 来创建无序列表。

* 项目一
* 项目二
  * 子项目 A
  * 子项目 B
* 项目三

效果：

项目一
项目二
- 子项目 A
- 子项目 B
项目三

有序列表 (Ordered Lists)

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

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

效果：

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

链接 (Links)

Markdown 的链接语法非常直观。

行内链接 (Inline Links)

[链接文本](URL "可选的标题")

示例：[澳客官网](https://www.aoke.cn "访问澳客网") -> 澳客官网

参考式链接 (Reference-style Links)

这种方式在文章中更常用，可以将 URL 定义在文章的底部，提高可读性。

这是一个参考式链接：[澳客网][aoke-link]。

[aoke-link]: https://www.aoke.cn "澳客网官方"

效果：这是一个参考式链接：澳客网。

图片 (Images)

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

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

示例：![澳客Logo](/images/aoke-logo.png "澳客Logo")

代码 (Code)

行内代码 (Inline Code)

使用反引号 ` 来包裹行内代码。

示例：print("Hello, World!") -> print("Hello, World!")

代码块 (Code Blocks)

使用三个反引号 ``` 来包裹多行代码块。您还可以指定代码语言，以便进行语法高亮。

```python
def greet(name):
    print(f"Hello, {name}!")

greet("Aoke")


效果：
```python
def greet(name):
    print(f"Hello, {name}!")

greet("Aoke")

引用 (Blockquotes)

在段落前加上 > 符号来创建引用。

> 这是引用的内容。
> 它可以跨越多行。

效果：

这是引用的内容。它可以跨越多行。

分隔线 (Horizontal Rules)

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

***
---
___

效果：

表格 (Tables)

Markdown 支持创建表格，使用管道符 | 和连字符 - 来定义。

| 列标题 1 | 列标题 2 | 列标题 3 |
| :-------: | :------- | --------: |
|  居中   |  左对齐  |  右对齐   |
|   文本A   |   文本B   |   文本C   |
|   123   |   456   |   789   |

效果：