最初的MarkDown并没有规定表格格式。但是由于GitHub Flavored MarkDown和markdown-it等实现都支持这种表格形式,本文也将简介这一语法。
表格语法使得| - :具有更多语法意义(全部是ASCII中的符号,不要错用中文符号。)
个人建议,如果|与其他非空白符号之间最少空一个空格。
表格由行列组成。
不同行之间用Enter分隔(不需要双空格)。
同行之间分隔不同列使用|。行首和行尾也可以使用|,并且推荐这么做。
同一张表格,各行的列数(单元格数)应该相同(没有内容也要用空单元格凑)
一个表格的源代码第一行是表头。但是填写规则和普通单元格一样。
一个表格源代码的第二行不会渲染成一行单元格。它被用来分隔表头和普通单元格。这一行每一单元格都填写大于等于三个-。
在第二行的单元格还可以控制本列的对齐方式。在一串-左侧加:可以左对齐。右侧加右对齐。双侧加居中。
示例
| Left-aligned | Center-aligned | Right-aligned |
| :--- | :---: | ---: |
| git status | git status | git status |
| git diff | git diff | git diff |
效果
Left-aligned | Center-aligned | Right-aligned |
---|---|---|
git status | git status | git status |
git diff | git diff | git diff |