8 种常用Markdown语法

为什么你要会 Markdown？

如果你准备在这里（或任何一个技术博客/代码平台）写文章，那 Markdown 就是绕不开的基础功。它是一种"用纯文本就能表达排版"的标记语言：你看到的标题、加粗、列表、代码块、表格，本质都是几个符号拼出来的。好处是写起来快、不依赖编辑器、内容永远可迁移——今天在博客写，明天复制到 GitHub、公众号编辑器、语雀都基本通用。

这篇不教你背语法，而是站在"写一篇博客教程"的真实场景，把最常用的几招一次讲透。掌握了这些，排版一篇图文并茂的文章绰绰有余。

一、标题：搭好文章骨架

标题是文章的骨架。语法很简单：# 加空格再加文字，# 越多，级别越低。

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

实际写作时的习惯建议：

1. # 和标题文字之间保留一个空格，这是最标准的 Markdown 写法，也避免在某些平台被误判；

2. 文章的大标题请用二级标题 ## 起，因为多数博客系统（包括本站）会自动把文章标题渲染成"一级标题"，如果你内容里再用 #，就会和文章标题撞车、显得层级混乱；

3. 多用二级、三级标题把内容切块，本站会自动生成目录（TOC），读者能一眼看清文章结构。

图例（渲染效果示意）：

二、列表：把要点排整齐

写步骤、列清单是博客的高频需求。无序列表在行首加 -，有序列表在行首加 数字.：

- 文本一
- 文本二
- 文本三

1. 文本一
2. 文本二
3. 文本三

建议：步骤类的操作说明优先用有序列表，读者能顺着序号一步步来，不会乱。

图例：

三、链接和图片：让文章"有血有肉"

技术教程最离不开引用链接和配图。

插入链接的格式是 [显示文字](链接地址)：

[LearnKu 开发者社区](https://learnku.com)

插入图片的格式是 ![](图片链接地址)——注意它和链接很像，只是前面多了一个 !。图片文字留空即可：

![](https://example.com/xxx.png)

配图建议：把图片先传到图床拿到稳定的直链（本站有自带图床上传），不要贴本地路径，否则换设备或发到别处会裂图。

图例：

四、引用：引用他人文字

要引用别人说过的话，或者做"注意事项"提示，在文字前加 > 即可：

> Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，
> 然后转换成格式丰富的 HTML 页面。

渲染后是一段带竖线的"引用块"，很适合放备注、出处、警告。

图例：

五、行内代码与代码高亮

写技术教程，命令、函数名、文件路径这类"程序里的词"，用反引号包起来变成行内代码：

Laravel 框架的所有配置文件都保存在 `config` 目录中。
可以使用 `config()` 辅助函数来读取。

而整段代码，用三个反引号包裹，并在开头标注语言，就能得到带语法高亮的代码块：

```php
function say($msg) {
    return "Hello " . $msg;
}
```

提示：写教程时，凡是让读者"复制后运行"的命令，都务必放进代码块并标注语言，这样读者复制不会丢格式，也方便阅读高亮。

图例：

六、粗体、斜体、表格

加粗用两个 * 包住文字，斜体用一个 * 包住文字：

Markdown 的 **粗体** 和 *斜体* 非常简单。

表格用竖线 | 分隔列，用 --- 分隔表头，通过冒号控制对齐：

| 项目 |  价格 | 数量  |
| :----- | ------: | :-: |
| iPhone |  6000 元 |  5  |
| iPad   |  3800 元 | 12  |
| iMac   | 10000 元 | 234 |

其中 :--- 表示左对齐、---: 右对齐、:--: 居中，表格很适合放参数说明、版本对比这类结构化信息。

图例：

个人结论

Markdown 学起来十分钟，用起来受益一辈子。你不需要把上面所有语法背下来，先记住标题、列表、链接、代码块这四样，就已经能写出结构清晰的文章了；等遇到表格、引用时再回来翻这篇当速查手册即可。写得越多越熟练，最终你会发现，写文章的速度甚至比用 Word 拖鼠标排版还快。