Markdown 表格:怎么写,怎么读

Markdown 表格是会变成网格的纯文本。你输入文字、竖线 | 和短横线 -,Markdown 阅读器就会显示出行和列。

表格在 Markdown 文件中随处可见:价目表、计划、对比、测试结果。AI 聊天和编程智能体经常写表格。

基本表格

| Fruit  | Colour | Price |
|--------|--------|-------|
| Apple  | Red    | 1.20  |
| Banana | Yellow | 0.50  |

它显示的效果如下:

FruitColourPrice
AppleRed1.20
BananaYellow0.50

共有三种行:

  1. 表头行:列名。
  2. 短横线行:把表头和其余部分分开。它是必需的。没有它,就没有表格。
  3. 数据行:每行一行文字。

竖线 | 分隔各个单元格。每行开头和结尾的竖线是可选的,但它们能让表格更易读。

各列在你的文本中不必对齐。这样写也可以:

| Fruit | Colour | Price |
|---|---|---|
| Apple | Red | 1.20 |

在表格前后各留一个空行。表格在第一个空行处结束。

对齐各列

在短横线行中加入冒号 ::

| Left | Centre | Right |
|:-----|:------:|------:|
| a    | b      | 1.20  |
| aa   | bb     | 10.50 |
LeftCentreRight
ab1.20
aabb10.50

在单元格内设置格式

单元格里可以放 粗体、斜体、代码 和链接:

| Task      | Status   | Link                         |
|-----------|----------|------------------------------|
| Write     | **Done** | [Notes](https://example.com) |
| `npm test`| *Running*|                              |

要在单元格里放一个竖线,请写成 \|。否则它会开启一个新的单元格。在 代码 里也是如此。

表格做不到的事

宽表格

列很多的表格会变得很宽,在手机上尤其如此。几个小建议:

快速制作表格的方法

阅读 Markdown 表格

在纯文本编辑器中,表格依然是竖线和短横线。小表格这样还能读,大表格就很难读了。Markdown 阅读器显示的是真正的网格。

PilcrowMD 在 Android 和 Mac 上显示 Markdown 表格。单元格中可以显示粗体、斜体、链接和数学公式。在 Android 上,宽表格可以横向滚动,因此各列不会被挤压。

常见问题

Markdown 表格在所有地方都一样吗? 大体上是。表格属于 GitHub Flavored Markdown,大多数应用都遵循它。少数非常简单的 Markdown 应用根本不显示表格。

我能在单元格里加换行吗? 标准 Markdown 不行。有些应用接受 HTML 标签 <br>,但并非所有应用都接受。

我需要把竖线对齐吗? 不需要。这只是让文本更易读。

Mac 上同样可用: PilcrowMD Mac 版(测试版)