tutorial tables markdown docx

DOCX 到 Markdown 与表格:完整指南

如何将带有表格的 Word 文档转换为 Markdown GFM 表格格式。保留表格结构和处理复杂布局的技巧。

W
WordToMD 团队
·

表格是将 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 等效项。转换器将输出没有跨越的单元格内容,这可能会导致列未对齐。

嵌套表 — 表内的表被展平为其文本内容。

复杂格式 — 保留表格单元格内的粗体、斜体和内联代码,但可以简化复杂的嵌入内容。

针对桌面文档的提示

  1. 避免合并单元格 如果可能的话——在转换之前将它们分开
  2. 使用标题行样式 — 右键单击第一行并将其标记为标题行以获得最佳结果
  3. 保持列计数一致 — 对于有效的 GFM 表,每行必须具有相同数量的单元格
  4. 转换后审核 — 在发布之前始终在 Markdown 预览中检查表格输出

渲染 Markdown 表

一旦你有了 Markdown 表格,它就会在以下位置正确呈现:

  • GitHub(自述文件、问题、PR)
  • GitLab
  • Notion
  • Obsidian
  • 大多数静态站点生成器(Jekyll、Hugo、Astro)
  • VS Code Markdown 预览

尝试一下 WordToMD 的免费转换器 — 只需拖放您的 .docx 文件,您的表格就会立即呈现为干净的 GFM Markdown。