Markdown 表格生成器

输入模式

第一行为表格表头。

列对齐方式

实时预览

如何使用 Markdown 表格生成器

1. 1. 选择输入模式。 可视化网格编辑器提供一个 3 × 3 的网格供输入,并有添加或删除行和列的按钮(至少 2 行、1 列)。粘贴 CSV / TSV 接受从电子表格或文本文件复制来的数据。
2. 2. 填写表格。 第一行始终是表头。在粘贴模式下,每一行即为表格的一行。
3. 3. 设置对齐方式。 每一列都有一个下拉菜单,可选择左、居中或右。
4. 4. 复制 Markdown。 填充后的表格显示在 Markdown 下方,下方是实时预览。复制 Markdown 会复制源代码。

Markdown 表格是如何构成的

表格并非核心 Markdown 或 CommonMark 规范的一部分;它来自 GitHub Flavored Markdown 规范,GitHub、GitLab 以及许多文档工具都遵循该规范。表格由一行表头、一行分隔行和任意数量的正文行组成,单元格之间以竖线分隔。分隔行使其成为表格:每个单元格由连字符组成,冒号用于设置对齐方式。

表头行的单元格数必须与分隔行相同,否则表格无法被识别。单元格中的竖线必须写作 \|,本生成器会为您自动处理。单元格只能包含单行文本,但粗体或链接等行内格式在单元格中仍然有效;表格在第一个空行处结束。

示例

将 Name,Role,Score 作为第一行粘贴,然后依次粘贴 Alice,Editor,92、Bob,Writer,7 和 C|D,Reviewer,100,共四行,并将各列分别设为左对齐、居中和右对齐。结果如下:

| Name  |   Role   | Score |
| :---- | :------: | ----: |
| Alice |  Editor  |    92 |
| Bob   |  Writer  |     7 |
| C\|D  | Reviewer |   100 |

每一列都会填充到其最宽单元格的宽度,使竖线对齐,最小宽度为三个字符。源码比表格所需的更长,但在纯文本差异比较中更易读,而且渲染效果与未填充的版本完全相同。C|D 中的竖线已被转义。如果所有列都保持默认设置,则每个分隔单元格都会变为左对齐的 :----。

粘贴模式的限制

• 分隔符。 生成器会在前几行中依次尝试逗号、制表符和分号,并使用能使各行列数最一致的那一个;若并列,则取逗号。
• 带引号的字段。 双引号括起的字段会保留其中的逗号,例如 "Smith, J.";连续两个双引号会变为一个。带引号的字段内的换行会变为 <br>,因为 Markdown 表格单元格必须保持在一行内。
• 对齐按字符数计算。 中日韩文字或表情符号等宽字符可能使源码看起来参差不齐,但渲染后的表格不受影响。
• 行长不一致时,会用空单元格补齐至最宽的行。

您需要哪个工具?

常见问题

如何创建 Markdown 表格?

在网格中输入表头和单元格内容,或切换到粘贴模式并粘贴 CSV 或制表符分隔的数据。生成器会写出表头行、分隔行和正文行,并显示渲染预览供您检查。

如何在 Markdown 表格中设置列对齐方式?

为该列选择左、居中或右。所选对齐方式会通过冒号写入分隔行:左对齐为 :---,居中为 :---:,右对齐为 ---:。

可以将 CSV 转换为 Markdown 表格吗?

可以。在粘贴模式下粘贴以逗号或制表符分隔的行即可。带引号的字段会被正确处理,因此 "Smith, J." 这样的单元格会保留在同一列中,引号内的换行会变为换行标签。

为什么列要用空格填充?

为了让竖线在纯文本中对齐。Markdown 渲染器会忽略多余的空格,填充后的源码更易阅读和编辑。

如果数据中包含竖线字符会怎样?

它会被转义为 \|,从而显示为竖线,而不会开始一个新列。

可以在表格单元格中放置换行或列表吗?

本工具不支持:单元格只能是单行文本。如果您自行在文本中加入行内 <br> 标签,大多数渲染器会接受,但这是渲染器的功能,而非表格语法的一部分。

我的数据会被上传到任何地方吗?

不会。表格在您的浏览器中构建并预览;不会有任何内容发送到 CitationEasy。