表格是将 Word 文档转换为 Markdown 时最棘手的元素之一。本指南向您准确展示表格转换的工作原理以及如何获得最佳结果。
Word 表格如何变成 Markdown 表格
Markdown(特别是 GitHub Flavored Markdown 或 GFM)支持使用管道字符的表格:
| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1 | Cell 2 | Cell 3 |
| Cell 4 | Cell 5 | Cell 6 |
转换 Word 文档时,表格的第一行(如果样式为标题行)将成为 GFM 表格标题,其下方有一条虚线分隔线。
转换良好的表结构
简单数据表 可以完美转换:
| 特点 | 支持 | 注释 |
|---|---|---|
| 标题行 | ✓ | 第一行映射到
首先 --- separator |
| 多列 | ✓ | 多达 20 多个列 |
| 数字和文本 | ✓ | 混合单元格内容有效 |
| 单元格中的链接 | ✓ | 保留超链接 |
已知限制
合并单元格 — 当 Word 单元格跨越多列或多行 (colspan/rowspan) 时,没有 Markdown 等效项。转换器将输出没有跨越的单元格内容,这可能会导致列未对齐。
嵌套表 — 表内的表被展平为其文本内容。
复杂格式 — 保留表格单元格内的粗体、斜体和内联代码,但可以简化复杂的嵌入内容。
针对桌面文档的提示
- 避免合并单元格 如果可能的话——在转换之前将它们分开
- 使用标题行样式 — 右键单击第一行并将其标记为标题行以获得最佳结果
- 保持列计数一致 — 对于有效的 GFM 表,每行必须具有相同数量的单元格
- 转换后审核 — 在发布之前始终在 Markdown 预览中检查表格输出
渲染 Markdown 表
一旦你有了 Markdown 表格,它就会在以下位置正确呈现:
- GitHub(自述文件、问题、PR)
- GitLab
- Notion
- Obsidian
- 大多数静态站点生成器(Jekyll、Hugo、Astro)
- VS Code Markdown 预览
尝试一下 WordToMD 的免费转换器 — 只需拖放您的 .docx 文件,您的表格就会立即呈现为干净的 GFM Markdown。