使用方法
- 在第一行输入标题,下方输入数据,或打开“从 CSV 填充…”并从电子表格粘贴单元格。
- 使用按钮添加或删除行和列。
- 使用每列上方的菜单设置对齐方式。
- 选择 Markdown 或 HTML,然后复制或下载表格。
工作原理
Markdown 输出遵循 GitHub Flavored Markdown(GFM)的表格语法,GitHub、GitLab、许多文档生成器以及大多数 Markdown 编辑器均支持该语法。第一行为表头,其后是用于设置对齐方式的分隔行::--- 表示左对齐,:---: 表示居中,---: 表示右对齐,--- 表示默认对齐。
单元格内容会被转义,以免破坏表格:单元格中的 | 会写作 \|,换行会变为 <br>,因为 GFM 表格行必须保持在一行内。单元格中的其他 Markdown(如 **粗体** 或 `代码`)会保留,并由 Markdown 查看器渲染。启用“用空格对齐列”后,每一列都会填充到相同宽度,使表格作为纯文本也易于阅读;中文、日文、韩文等字符按两个列宽计算。单元格较少的行会以空单元格补齐。
导入功能支持制表符分隔文本(电子表格复制到剪贴板时的格式)、使用逗号或分号的 CSV(包括带逗号、引号和换行的引号字段),以及现有的 Markdown 表格(同时读取其对齐行)。
HTML 输出为包含 <thead> 和 <tbody> 的普通 <table>。文本会进行 HTML 转义(& < > "),换行变为 <br>,对齐方式通过内联 text-align 样式设置,因此无需样式表即可生效。
示例
电子表格转 README
在 Google Sheets 中选择一个区域,复制后粘贴到导入框中,然后点击“填充表格”。将价格列设置为右对齐,再把 Markdown 复制到 README.md。
包含竖线字符的文本
包含“Unlimited | fair use”的单元格会写作 Unlimited \| fair use,这样 GitHub 会显示竖线,而不是另起一列。
整理现有表格
粘贴一个间距不整齐的手写 Markdown 表格,点击“填充表格”,然后将结果复制回去,所有列都会对齐并保留对齐方式。
常见问题
单元格中可以包含换行吗?
不能作为真正的换行,因为 Markdown 中每个表格行必须是一行。生成器会改为写入 <br>,GitHub 和大多数查看器会将其显示为换行。
为什么必须要有标题行?
GFM 表格始终以标题行开头,其后跟着对齐行。如果不希望显示可见标题,可以将标题单元格留空,但大多数查看器仍会绘制标题分隔线。
可以合并单元格吗?
不支持。Markdown 表格不支持合并单元格(colspan 或 rowspan)。如果需要,请使用 HTML 输出并手动添加 colspan 或 rowspan 属性。
填充会改变渲染后表格的外观吗?
不会。渲染 Markdown 时多余的空格会被忽略。填充只会使源代码更易于阅读和编辑。
隐私
表格仅在您的浏览器内生成。您输入或粘贴的数据不会被上传、存储或用于分析。