DevToy

Markdown 表格

Markdown 表格对齐:左对齐、居中和右对齐

了解分隔行中的冒号如何控制 Markdown 表格对齐,以及不同对齐方式在技术文档中的作用。

发布于 2026年7月11日 · 更新于 2026年7月11日

Markdown 表格的对齐方式写在分隔行里,而不是数据单元格里。左侧冒号表示左对齐,两侧冒号表示居中,右侧冒号表示右对齐。

三种对齐形式

| 名称 | 状态 | 时长 |
| :--- | :----: | -------: |
| Build | Passed | 42 s |
| Deploy | Waiting | 3 min |

上面的源文件分别使用了 :---:---:---:。连字符数量通常可以变化,但至少写三个最稳妥。多出来的空格只是为了让源码更容易阅读,通常不会影响渲染结果。

按语义选择对齐方式

左对齐最适合名称、说明、URL 和其他文本。读者会从同一个起始边缘开始扫读。

居中适合简短的分类值,例如 yes/no、图标或构建状态。不要把长句居中,因为起始位置不断变化会降低扫描效率。

右对齐适合价格、数量、时长、百分比和其他便于比较的数值型内容。Markdown 渲染器依然会把它们当作文本,因此右对齐不会带来电子表格那种排序或计算能力。

让源码更易维护

把每个单元格补齐到相同宽度,源码会更整齐,便于审阅,但这不是必须的。下面这两个表格在渲染后通常一样:

| Key | Value |
| :-- | ----: |
| A | 10 |

如果值经常变化,应该使用格式化工具,而不是手工数空格。格式化器在处理 emoji 或宽字符 CJK 时要注意显示宽度,JavaScript 的字符串长度不等于视觉宽度。

排查对齐失效

如果所有列都变成左对齐,先检查目标平台是否支持 GitHub Flavored Markdown 表格。CommonMark 本身并没有定义表格语法。然后确认分隔行的单元格数量和表头一致,并检查是否有未转义的竖线导致多出一列。

可以在 Markdown 表格编辑器 里切换列对齐,并立即查看生成的分隔行。

相关指南