Markdown 语法速查表

Markdown 的语法很少，半天就能上手。下面按“写文章真正会用到”的顺序排，每种写法都给了源码和效果说明。原样复制到编辑器里试最快。

一、标题

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

一共六级，井号后面留一个空格。一篇公众号文章一般只用三级：# 用作标题（或直接不写，用二级开头），## 分大段，### 分小点。

二、文字样式

中文排版里很少用斜体（中文字体斜体不好看），重点用加粗就够了。

三、列表与任务清单

- 无序列表
- 第二项
  - 缩进两格就是子项

1. 有序列表
2. 第二项

- [x] 已经做完的事
- [ ] 还没做的事

任务清单在公众号里会显示成勾选框，很适合写「清单体」的文章。

四、引用、分割线与链接

> 这是一段引用，用来放结论、金句或别人的话
> 可以连着写好几行

---

[随浪工具站](https://suilang.net)

链接写成 [显示文字](地址)。复制到公众号时链接会保留，读者点一下就能跳。

五、图片

![图片说明](图片地址)

![本地图片也可以，直接粘贴进编辑器](/assets/xxx.jpg)

最省事的方式是直接把图片拖进编辑区或者截图后粘贴，编辑器会在本地压缩成内联图片。粘贴到公众号后如果图片没出现，在微信后台重新上传一次即可（微信对跨站图片有限制）。

六、表格

| 功能 | 快捷键 |
| --- | --- |
| 加粗 | ⌘ / Ctrl + B |
| 链接 | ⌘ / Ctrl + K |

第二行的 --- 不能省，它决定哪些列是表头。对齐可以用 :---（左）、:---:（中）、---:（右）。

七、代码块

```js
function hello(name) {
  return `你好，${name}`;
}
```

```
不带语言名也可以，只是没有高亮
```

围栏后面写上语言名（js、python、bash、json、html、css、sql…），编辑器会自动高亮。公众号对代码块的支持有限，长代码建议截图。

八、数学公式

行内公式：$E = mc^2$
独立成行：

$$
\int_0^1 x^2 \, dx = \frac{1}{3}
$$

编辑器会先把公式抠出来再渲染，所以公式里的 _、*、\ 不会被 Markdown 的强调语法吃掉 —— 这是很多在线编辑器会出错的地方。

九、流程图、时序图（Mermaid）

```mermaid
flowchart LR
  A[开始] --> B{判断}
  B -- 是 --> C[做这件事]
  B -- 否 --> D[做那件事]
```

被 mermaid 标记的代码块会画成图。常用的三种：flowchart（流程图）、sequenceDiagram（时序图）、gantt（甘特图）。

十、常用快捷键

下一步

语法会了，接着看怎么把写好的文章发到公众号。写的过程中随时可以在编辑器里试。