Markdown 语法详解

Jan 20, 2026 · 6 mins read

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的HTML。由于其简洁的语法和广泛的应用，Markdown 已成为许多开发者、博主和内容创作者的首选写作工具。本教程将详细介绍 Markdown 的核心语法，帮助您掌握其精髓。

Markdown 使用井号 (#) 来创建标题，井号的数量决定了标题的级别。

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

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

这是第一个段落。

这是第二个段落。

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

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

无序列表: 使用星号 (*)、加号 (+) 或减号 (-)。

* 项目一
* 项目二
  * 子项目二.一
  * 子项目二.二
* 项目三

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

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

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

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

这是 [一个链接到百度](https://www.baidu.com "百度首页") 的例子。

引用链接:

这是 [一个链接到Google][google] 的例子。

[google]: https://www.google.com "Google 搜索"

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

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

![Markdown Logo](https://markdown.org/assets/img/markdown-logo.png "Markdown Logo")

引用图片:

![Markdown Logo][logo]

[logo]: https://markdown.org/assets/img/markdown-logo.png "Markdown Logo"

Markdown 支持行内代码和代码块。

行内代码: 使用反引号 (`) 包围。

使用 `print("Hello, World!")` 来输出文本。

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

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

greet("World")
```

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

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

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

---
***
___

Markdown 支持创建表格，使用管道符 (|) 和连字符 (-)。

| 列标题1 | 列标题2 | 列标题3 |
| :------ | :------ | :------ |
| 行1单元格1 | 行1单元格2 | 行1单元格3 |
| 行2单元格1 | 行2单元格2 | 行2单元格3 |

其中，冒号 (:) 用于控制文本对齐：

使用两个波浪号 (~~) 包围文本。

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

在列表项中使用方括号 [] 来创建任务列表。

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

掌握这些 Markdown 语法，您将能够更高效地创建和管理您的内容。无论是撰写技术文档、博客文章还是简单的笔记，Markdown 都能为您提供极大的便利。