如何将 JSON 或 CSV 转换为 Markdown 表格

先了解输入与输出

这款 Markdown 表格生成工具适合把 JSON 或 CSV 文本整理成 Markdown 表格，方便复制到文档、说明页面或支持 Markdown 的编辑器中。你可以直接提交文本，选择输入格式，并按需要提供自定义表头和对齐方式。处理成功时，工具会返回格式化的 Markdown 表格文本。

按步骤生成表格

1. 准备 JSON 或 CSV 文本。不要留空提交，因为没有数据时计算会失败。
2. 选择与内容对应的格式：JSON 或 CSV。其他格式值不受支持。
3. 如果使用 JSON，提供能表示表格行的结构。非空 JSON 对象会被当作一行；在没有自定义表头时，合适的非空 JSON 行结构会使用第一行的键作为表头。
4. 如果使用 CSV 且不填写自定义表头，第一行会作为表头，后续各行作为数据行。CSV 的行和字段按换行符、逗号拆分，每个字段两侧的空白会被移除。
5. 可选地输入逗号分隔的自定义表头。每个表头两侧的空白会被移除。然后选择左对齐、居中或右对齐；不选择时默认为左对齐。
6. 提交并查看生成的 Markdown 表格文本。若输入是空 JSON 值，例如空列表、空对象、null、false、0 或空字符串，结果会是空表，而不是包含数据的表格。

如何检查结果

成功结果应是一段可复制的 Markdown 表格文本。JSON 的表头通常来自第一行的键，除非你提供了自定义表头；CSV 在未指定自定义表头时则使用首行内容。对齐选项会影响表格标记：支持左、居中和右三种方式，未知的对齐值会回退为左对齐。

结果是否成功取决于输入能否形成工具预期的行结构。格式错误的 JSON 会处理失败，某些虽然语法有效但结构不合适的 JSON 也可能无法生成表格。CSV 处理按简单的换行和逗号拆分，不应把它当作支持复杂引用规则的完整 CSV 解析器；超过表头数量的字段会被丢弃，缺少的字段会留下空值。

使用示例

你要把一小段产品库存数据整理成可粘贴到 Markdown 文档中的表格。

准备一段包含产品名称和库存数量的 JSON 行结构，选择 JSON 格式并提交；如需指定显示名称，可填写逗号分隔的自定义表头，再查看生成的 Markdown 表格文本。

处理成功后，结果是一段包含表头行、分隔线和数据行的 Markdown 表格文本；具体单元格内容取决于输入。

使用限制

• CSV 内容按换行符和逗号直接拆分，复杂的引号、嵌套分隔符等规则不在已确认的处理范围内；多出的字段会被丢弃，缺少的字段会显示为空值。

常见错误

• 如果提交了格式错误的 JSON，或选择了不支持的格式，处理会失败。请先检查 JSON 语法和行结构，再确认格式选择为 JSON 或 CSV。

常见问题

JSON 对象可以转换成 Markdown 表格吗？

可以，但前提是 JSON 能提供工具预期的行结构。非空 JSON 对象会作为一行处理；格式错误或结构不合适的 JSON 可能处理失败。

CSV 的第一行一定会成为表头吗？

可以。未填写自定义表头时，CSV 的第一行作为表头，后续行作为数据；填写自定义表头后，则使用你提供的逗号分隔表头。

为什么没有生成包含数据的表格？

如果输入的是空 JSON 值，结果会是空表。若输入没有数据，提交会导致计算失败；这两种情况需要分别检查数据内容和是否留空提交。