Markdown 表格完整指南 (GFM)
Markdown表格的完全指南,在实际文档中真正可用。涵盖GitHub风格Markdown (GFM)语法、对齐、单元格内的链接/图片/代码、多行单元格,以及CSV/Excel ⇄ Markdown之间的转换。
提示:使用我们的在编辑器中尝试表格按钮创建具有实时预览的完美表格,然后导出DOCX/PDF,获得真正的Word表格(保持边框和对齐)。
目录
基本语法
| 功能 | 支持情况 |
|------|----------|
| 表格 | ✅ |
| 对齐 | ✅ |
- 第一行是表头。
- 第二行的破折号定义表格并支持对齐标记。
对齐方式
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容 | 内容 | 内容 |
:---= 左对齐,:---:= 居中对齐,---:= 右对齐。
单元格中的链接、图片、代码
| 类型 | 示例 |
|--------|------------------------------|
| 链接 | [md2word](https://md2word.com) |
| 图片 |  |
| 代码 | `内联代码` |
块级元素(列表、引用块)在不同解析器中无法可靠地在单元格内支持——建议每个单元格内容简洁。
多行单元格
CommonMark本身不支持单元格内的硬换行,但许多渲染器接受<br>:
| 功能 | 说明 |
|------|--------------------------|
| 多行 | 第1行<br>第2行<br>第3行 |
对于较长内容,考虑拆分行或切换到HTML表格以获得精确布局。
列宽与换行
Markdown没有原生的列宽控制。如需固定宽度,请使用CSS/HTML。 当通过md2word导出时,列会像Word表格一样自动适配并保持对齐/边框。
CSV / Excel ⇄ Markdown
CSV → Markdown
- 将CSV粘贴到转换器中。
- 选择"CSV → Markdown表格"。
- 调整对齐;复制或导出为DOCX/PDF。
Markdown → CSV/Excel
- 将检测到的表格导出为CSV或.xlsx以便电子表格编辑。
CSV示例:
姓名,分数,通过
张三,92,TRUE
李四,78,TRUE
王五,63,FALSE
转换后的Markdown:
| 姓名 | 分数 | 通过情况 |
|------|-----:|:--------:|
| 张三 | 92 | ✅ |
| 李四 | 78 | ✅ |
| 王五 | 63 | ❌ |
HTML表格(当Markdown不够用时)
当需要rowspan/colspan、精确宽度或嵌套内容时,请使用HTML:
<table>
<thead>
<tr><th>季度</th><th colspan="2">收入</th></tr>
</thead>
<tbody>
<tr><td>Q1</td><td>$1.2M</td><td>$1.4M</td></tr>
</tbody>
</table>
md2word会将HTML表格转换为真正的Word表格,具有合并单元格功能。
平台差异
| 平台 | 表格 | 对齐 | 说明 |
|---|---|---|---|
| GitHub (GFM) | ✅ | ✅ | 最常用;不支持colspan/rowspan |
| Obsidian | ✅ | ✅ | 在预览中有效;导出取决于插件 |
| Notion | ⚠️ | ⚠️ | 导入Markdown但使用原生表格 |
| Discord/Reddit | ⚠️ | ⚠️ | 有限或无支持;考虑截图或代码块 |
常见问题
问:为什么我的列在纯文本编辑器中看起来不对齐? 空格只是装饰性的。渲染引擎会忽略它们;请在表头行中使用对齐标记。
问:我可以合并单元格吗?
纯Markdown中不行。使用HTML表格实现rowspan/colspan或重构数据。
问:我的表格在复制粘贴到Word后格式乱了 使用md2word导出获得具有一致边框和对齐的合适DOCX表格。
问:表格可以有多大? Markdown解析器可以处理大型表格,但浏览器会变慢。考虑分块或切换到CSV/Excel进行编辑,然后重新导出。
更新日志
- 2025-10-16:中文版本发布,支持CSV/Excel双向转换和HTML回退指导。
下一步:
- 使用在编辑器中尝试表格创建具有实时预览和导出功能的表格。
- 探索相关文档:Markdown速查表、Markdown超链接、Markdown转PDF。