Markdown 是一种轻量级标记语言，用简单的符号就能写出结构清晰的文档。这篇教程覆盖了最常用的语法，随查随用。

标题

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果：

一级标题

二级标题

三级标题

段落与换行

1
2
3
4
这是第一段。
直接换行不会分段，需要加一个空行。

这是第二段。

段落之间用空行分隔。行尾加两个空格再回车可以强制换行，但更推荐用空行。

文字样式

1
2
3
4
5
6
**粗体**
*斜体*
***粗斜体***
~~删除线~~
`行内代码`
<u>下划线</u>

效果：粗体 斜体 粗斜体 删除线 行内代码 下划线

列表

无序列表

1
2
3
4
5
- 苹果
- 香蕉
- 橘子
  - 嵌套列表（缩进两个空格）
  - 继续嵌套

有序列表

1
2
3
1. 第一步
2. 第二步
3. 第三步

任务列表

1
2
3
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个待办

链接

1
2
3
4
5
[显示文字](https://example.com)

[带标题的链接](https://example.com "鼠标悬停提示")

[相对链接](/posts/about.html)

效果：显示文字

图片

1
2
3
4
5
![替代文字](https://example.com/image.png)

![带标题的图片](https://example.com/image.png "图片标题")

![本地图片](/img/covers/blog-migration-guide.png)

引用

1
2
3
4
5
> 这是一段引用。
>
> > 这是嵌套引用。
>
> 引用可以包含多个段落，用空行分隔。

效果：

这是一段引用。

这是嵌套引用。

引用可以包含多个段落，用空行分隔。

代码

行内代码

1
在文字中可以用 `code` 来表示代码片段。

代码块

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
```python
def hello():
    print("Hello, Markdown!")
```

```bash
# 终端命令
git add .
git commit -m "feat: add new feature"
```

```javascript
const greet = (name) => {
  return `Hello, ${name}!`;
};
```

支持的语言标识：python bash javascript html css json yaml go rust 等。

表格

1
2
3
4
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 单元格 | 单元格   | 单元格 |
| 内容   | 内容     | 内容   |

效果：

左对齐 居中对齐 右对齐
单元格 单元格 单元格
内容 内容 内容

分割线

1
---

用三个或以上的 - * _ 都可以。

转义字符

在特殊符号前加反斜杠 \ 即可显示原字符：

1
2
\*这不是斜体\*
\[这不是链接\]

进阶用法

脚注

1
2
3
这是一段文字[^1]。

[^1]: 这是脚注的内容，通常在页面底部显示。

锚点

1
[跳转到标题](#标题)

Emoji

1
:smile: :heart: :rocket: :fire:

😄 ❤️ 🚀 🔥

折叠块（HTML）

1
2
3
4
<details>
  <summary>点击展开</summary>
  这里是被隐藏的内容。
</details>
点击展开 这里是被隐藏的内容。

Hexo 专属语法

本站基于 Hexo，额外支持：

文章内嵌图片

1
{% asset_img example.png 替代文字 %}

文章摘要

1
2
3
4
5
这里是文章的开头部分，会被显示为摘要。

<!-- more -->

这里是「阅读全文」之后才会显示的内容。

资源文件夹引用

1
{% post_link 文章标题 显示文字 %}

速查表

语法 效果
# 标题 一级标题
**文字** 粗体
*文字* 斜体
~~文字~~ 删除线
`代码` 代码
> 引用 引用块
- 列表 无序列表
1. 列表 有序列表
[文字](url) 链接
![](url) 图片
``` 代码块
`\ 表 \ ` 表格
--- 分割线

Markdown 的核心就这些了。写多了自然就记住了，不记得的时候回来翻翻这篇就行。