表格

表格是 Markdown 原生语法中功能最受限的一块。它能做的事其实只有三件:把数据按行按列摆开、给每列指定一种对齐方式、让单元格里的内容按行内语法解析。仅此而已——不支持合并单元格,不支持嵌套表格,也不支持单元格里换行。正因如此,表格的难点不在语法,而在于判断「这份数据该不该做成表格」。

先给出准确的基本写法,再讲列对齐:分隔行里的冒号决定左对齐、居中还是右对齐,冒号写在哪一侧就往哪一侧偏,不写就是默认对齐。还会说明为什么表格里的竖线必须转义,以及一个更隐蔽的坑——转义竖线的规则在单元格内先于行内解析生效,所以写在行内代码里的竖线也会被一起吃掉。

判断一份数据该不该做成表格,有一个简单的标准:读者会不会逐行比对。会逐行比对的——参数对照、状态枚举、版本差异、命令与用途的对应——表格能省掉大量重复的措辞,让差异一眼可见。不会逐行比对的,表格只是把一段话硬切成方格,反而增加了阅读负担。表格还有一条硬约束:同一张表里每一行的列数必须一致,多出来的格子会被直接丢弃,少掉的则补成空单元格——所以写表格时,先把列定下来,再往里填。

章节

发现内容有问题?

告诉我们哪里需要改进。