2026年3月27日

Markdown 写作速查

这篇文章整理了一些常用的 Markdown 语法，方便写博客时随手查阅。

标题

下面的 <h1> 到 <h6> 代表六级标题，其中 <h1> 层级最高，<h6> 层级最低。

H1

H2

H3

H4

H5

H6

段落

Markdown 里的普通文字会自动组成段落。空一行就可以开始新段落，这也是写技术博客时最常用的基础格式。

段落之间尽量保持简洁，一段只表达一个重点，读起来会更舒服。

图片

写法

![图片说明](./图片路径.jpg)

效果

引用

引用块适合放摘录、观点或者需要特别强调的一段话。

不带出处的引用

写法

> 把想强调的话放在这里。  
> **注意**：引用块里也可以继续使用 _Markdown_ 语法。

效果

把想强调的话放在这里。
注意：引用块里也可以继续使用 Markdown 语法。

带出处的引用

写法

> 不要靠共享记忆来沟通，而要靠沟通来共享记忆。<br>
> —— <cite>Rob Pike[^1]</cite>

效果

不要靠共享记忆来沟通，而要靠沟通来共享记忆。
—— Rob Pike¹

表格

写法

| 斜体 | 加粗 | 行内代码 |
| ---- | ---- | -------- |
| _文字_ | **文字** | `code` |

效果

斜体	加粗	行内代码
文字	文字	`code`

代码块

写法

使用三个反引号包住多行代码；如果想启用语法高亮，可以在开头的反引号后面写语言名，比如 html、javascript、css、bash。

```html
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <title>Example HTML5 Document</title>
  </head>
  <body>
    <p>Test</p>
  </body>
</html>
```

效果

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <title>Example HTML5 Document</title>
  </head>
  <body>
    <p>Test</p>
  </body>
</html>

列表

有序列表

写法

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

效果

第一项
第二项
第三项

无序列表

写法

- 列表项
- 另一项
- 再来一项

效果

列表项
另一项
再来一项

嵌套列表

写法

- 水果
  - 苹果
  - 橙子
  - 香蕉
- 乳制品
  - 牛奶
  - 奶酪

效果

水果
- 苹果
- 橙子
- 香蕉
乳制品
- 牛奶
- 奶酪

其他元素：`abbr`、`sub`、`sup`、`kbd`、`mark`

写法

<abbr title="Graphics Interchange Format">GIF</abbr> 是一种位图图像格式。

H<sub>2</sub>O

X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>

按下 <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Delete</kbd> 可以打开系统安全选项。

大多数 <mark>蝾螈</mark> 都是夜行性动物，会捕食昆虫、蠕虫和其他小型生物。

效果

GIF 是一种位图图像格式。

H₂O

Xⁿ + Yⁿ = Zⁿ

按下 CTRL + ALT + Delete 可以打开系统安全选项。

大多数蝾螈都是夜行性动物，会捕食昆虫、蠕虫和其他小型生物。

这句话出自 Rob Pike 在 2015 年 11 月 18 日 Gopherfest 上的一次分享。 ↩