Markdown表格生成器

Markdown表格对格式要求极为严格:只要缺少一个管道符号或分隔行不平整,整个表格就会显示为纯文本。该生成器提供可视化的网格供用户输入数据,支持从电子表格中粘贴CSV或TSV文件,并生成带有填充边距的Markdown表格,其列排列方式与源文件一致,便于代码差异对比及首次修改即可修正。

如何创建Markdown表格

  1. 1

    选择行和列

    或直接粘贴CSV/TSV文件,工具将自动推断维度。

  2. 2

    输入单元格内容

    点击每个单元格。使用Tab键和箭头键可像操作电子表格一样进行导航。

  3. 3

    设置列对齐方式

    按列通过标题行选择左侧(默认)、中间或右侧。

  4. 4

    复制Markdown输出

    该工具会将管道符填充至列宽,使源代码呈现整洁外观。

Markdown表格语法

基本表格:

| 列 A   | 列 B   | 列 C   |
|--------|--------|--------|
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

对齐方式在分隔行中使用冒号:

| 左 | 居中 | 右 |
|:---|:----:|----:|
| a  | b    | c   |
  • :--- 左对齐
  • :---: 中心
  • ---: 右对齐

生成器为您提供的功能

  • 将每个单元格填充至其所在列中最长条目的宽度,使管道在源代码中对齐。此操作不会影响渲染结果(Markdown 会忽略多余空格),但阅读差异文件的读者会对此表示感谢。
  • 将单元格内的管道符转义为\|,因此含有a|b的单元格不会被拆分为两列。
  • 在更改列宽度时保持对齐方式不变。
  • 支持导入 CSV 和 TSV 格式文件;可识别带引号的字段以及引号内的逗号。

常见陷阱

  • 分隔行为必填项。 缺少 |---|---| 行的 Markdown 表格将显示为纯文本。
  • 不支持多行单元格。 每行仅占一行;如需内部换行,请插入 <br>,因为表格单元格内不支持 Markdown 的换行格式。
  • 不支持嵌套表格。如需使用,请改用 HTML。
  • 空单元格需留出空间(或至少使用一对空管道)。请避免直接使用||

何时改用 HTML

如果您需要跨列(colspan)、跨行(rowspan)、多行单元格或自定义CSS类,HTML表格才是合适的选择。大多数Markdown解析器都能直接内联处理原始HTML表格标记。

Markdown表格的适用场景

  • GitHub、GitLab、Gitea 的 README文档。
  • 问题描述及公关说明。
  • Obsidian、Bear以及大多数笔记应用程序。 Docusaurus、MkDocs和Hugo均支持 GFM 表格。

常见问题

并非原生支持。使用 <br> 实现内联换行。对于真正的多行内容(代码块、单元格内的列表),请改用 HTML 格式 <table>

GFM 不支持合并单元格。如需使用colspanrowspan,请在Markdown文档中直接插入HTML代码,大多数渲染器会原样呈现<table>

无论是否添加缩进,渲染后的HTML代码都完全一致,缩进纯属源代码可读性的设计选择。

是的。从电子表格复制内容时,系统会将TSV(制表符分隔值)格式保存到剪贴板。生成器可识别TSV格式,并自动生成具有相同行和列结构的Markdown表格。

输入 \|。大多数解析器随后会直接输出纯文本字符串,且不会跨越列边界。

相关工具

此工具还提供其他语言版本