MDFormats
博客

Word 文档整理

Markdown 表格转 Word：导出 DOCX，修复错列与分页

作者 MDFormats · 约 6 分钟 · 发布于

Markdown 表格转成 Word 后，先打开下载的 DOCX，确认数据没有错列或遗漏，再调整版面。浏览器预览和 Word 的页面宽度、字体不同，同一张表的换行和分页也可能不同。

下面用一份简短的检查表走完这个过程，并区分原文结构错误与 Word 排版问题。可以先试示例，也可以直接用这些检查项核对自己的表格。

本文目录

准备一张能逐格核对的 Markdown 表格

先选几行有代表性的数据。这份虚构的发布检查表包含前导零编号、行内命令、加粗文字和链接：

示例 1
# 发布检查

| 检查编号 | 检查事项 | 结果 |
| --- | --- | --- |
| 0017 | 运行 `npm run build` | 待检查 |
| 0042 | 检查**安装**步骤 | 需要复核 |
| 0090 | 打开[示例参考](https://example.com/) | 确认链接 |

表格有三列、三行数据；加上表头，导出后应为四行、十二个单元格。链接使用保留的示例域名，套用时请换成自己的参考地址。

原文中的每一行表格单独占一行。表头下的短横线分隔行用于识别表格；为对齐竖线而添加的空格只方便阅读原文，不会设定 Word 的实际列宽。GitHub 的表格编写说明介绍了这套语法及可用的行内格式。

导出为可编辑的 Word 表格

  1. 打开 Markdown 转 Word，用上面的示例 1替换编辑区原有内容。用示例的复制按钮即可取得原文，不会带上包在外面的三个反引号。
  2. 查看预览：应有三列、三行数据，标题在表格外。手机上可用右侧视图按钮仅看 Word打开预览。如果只看到竖线原文，先修复结构再导出。
  3. 点击下载 DOCX，保存 markdown.docx。
  4. 用 Word 或兼容编辑器打开文件，在一个数据单元格内修改文字，确认它可以编辑。

页面的示例区也提供示例 1的 Markdown 和 DOCX 下载。DOCX 由 MDFormats 浏览器工具实际生成。下图是浏览器工作台，不是 Microsoft Word 截图。

MDFormats 中文工作台中的发布检查原文与三列表格预览

预览适合检查结构。字体、换行和分页应在收件人使用的编辑器中确认。需要比较在线转换与 Pandoc 等方法时，可阅读已发布的 Markdown 转 Word 指南。

先核对数据，再调整列宽

用具体的单元格检查下载结果：

  • 0017、运行 npm run build 和“待检查”应在同一行；命令应保留行内代码样式。
  • 0042 对应安装步骤检查和“需要复核”，其中“安装”应仍为粗体。
  • 0090 对应示例参考和“确认链接”，链接目标仍为 https://example.com/。
  • 编号的前导零不能丢失。空白、零和未检查不是同一种含义，应说明缺失值代表什么。

长表格要逐行比对，包括第一页之后的内容。使用稳定编号，比只看行的位置更容易发现错位。以后拆成两张表时，两部分都保留编号，方便对应。

修复错列、漏值和无法识别的原文

先改原文结构，再美化 Word 文件，否则重新导出会带回同样的问题。

症状 检查位置 先做什么
竖线显示成普通文字 缺少分隔行，或整张表被代码围栏包住 补齐分隔行，只去掉最外层展示围栏
值移到了下一列 单元格内有竖线，或一行的列数不一致 按表头逐格检查该行
表格到一半就结束 表格中出现空行或新的内容块 连续放置表格行，把说明移到表格下
预览整齐却少了一个值 原文某行多格或少格 对照原始数据，重写有问题的行

下面故意省略了分隔行：

示例 2
| 检查编号 | 检查事项 | 结果 |
| 0017 | 运行构建 | 待检查 |

在两行之间补上 | --- | --- | --- |，每行保持三格。GFM 表格规范要求表头与分隔行的列数相同；正文行少的格子会补空，多出的格子会忽略。重要数据不能依赖这种自动处理。

单元格内的竖线需要转义。以下示例在 GFM 中的第一格表示 A|B：

示例 3
| 规则 | 含义 |
| --- | --- |
| A\|B | 两者之一 |

用实际的导出路径测试这一行。预览与 DOCX 转换器的语法支持可能不同。如果仍然错列，先把 Markdown 单元格里的表达式换成 RULE_TEXT，重新导出并确认该行只有两格，然后在 Word 的第一格中把 RULE_TEXT 换回精确的 A|B。代码也可以原样移到表格外，不要为避开竖线而改动运算符。

在 Word 中给宽表格留出空间

下面是六列原文。网页上的横向滚动能展示全部内容，却不能说明它适合纵向纸张：

示例 4
| 检查编号 | 组件 | 环境 | 负责人 | 依据 | 下一步 |
| --- | --- | --- | --- | --- | --- |
| 0017 | 安装程序 | 桌面端 | 发布组 | 构建日志 | 检查命令输出 |
| 0042 | 指南 | 文档 | 文档组 | 复核记录 | 确认安装步骤 |

先精简表格：缩短重复的表头，给链接起清楚的名称，把长说明移到表格下方的段落中。如果读者不需要同时看六列，可以拆成两张较窄的表，都保留检查编号。

必须保持宽表时，在 Word 中选中表格，打开表格布局 → 自动调整，选择让整张表格适应窗口宽度的选项。再给说明文字多分配一些宽度，给短编号少一些。Microsoft 的表格尺寸说明区分了适应窗口和适应内容，两种调整后都需要检查结果。

对齐方式也要单独确认。Markdown 的 :---、:---: 和 ---: 分别表示左、中、右对齐，但不能保证每条 DOCX 路径都产生相同效果。金额和编号尤其要检查；需要时在 Word 中设置单元格对齐，不要靠补空格定位。

当前工作台没有 DOCX 纸张方向或单列宽度控件。需要横向节时，请在 Word 中设置并检查前后页面。如果只需要供阅读的版本，Markdown 转 PDF提供纸张和方向选项，保存后仍要单独核对。

让跨页长表格保持可读

表格延续到下一页时，重复表头有助于读者理解数据。桌面 Word 中可选中表头行，在表格布局中选择重复标题行；选区要包含表格的第一行。Microsoft 的重复表头说明指出，重复表头在打印布局或打印时可见；表格内部手动插入分页符时，不会在该处自动重复。

如果一行被拆到两页，检查表格属性 → 行中的跨页断行设置，操作依据见 Microsoft 的表格属性说明（英文）。不允许断行可能把整行移到下一页。如果一格放了很长的说明，更合适的做法通常是移到表格下，而不是缩小整篇文字。不同 Word 版本的名称和可用选项可能不同。

修改后检查开头、中间和最后几页。这些是用户在 Word 中的调整，不是 MDFormats 自动应用的设置。

简化需要复杂结构的单元格

这里使用的 GFM 表格可以放文字、链接、加粗和短代码，但没有合并单元格的语法，也不能在格内嵌套另一张表或放入多段列表。如果原表用合并的“负责人”表头统领两列，可改成“当前负责人”和“后续负责人”，需要的合并版式再到 Word 中制作。

添加 HTML 也不代表 DOCX 会得到相同布局。此流程的 Word 导出不会嵌入引用图片；请在 Word 中添加必要图片，然后重新检查表格排版。

常见问题

可以直接把 Markdown 表格粘贴到 Word 吗？

可以粘贴文字，但不要默认 Word 会把竖线解释成表格语法。如果已有网页上排好的表格，可以试着复制粘贴，再检查单元格能否编辑。只有 Markdown 原文时，使用 DOCX 导出或其他支持 Markdown 的转换路径。

为什么导出后的列宽和原文不同？

竖线两边的空格不指定实际尺寸。预览宽度、页边距、字体和列宽设置都会影响换行。请在 Word 中调整导出的表格；这样的调整不会反向修改 Markdown。

Markdown 表格中可以合并单元格或插入长列表吗？

这些结构不属于 GFM 竖线表格语法。可在格内留下简短索引，把说明移到下方，或在 Word 中制作复杂结构。

预览看起来正确，是否说明每个值都保留了？

不能。仍要用下载文件对照原文，检查编号、行内对应关系、链接和最后几行。版面整齐也可能存在漏值或错位。

交付可编辑、可核对的表格

Markdown 表格转 Word，先检查内容，再检查版面。用 Markdown 转 Word试跑示例，核对十二格，再在目标编辑器中处理列宽和分页。为以后修订另存一份 .md 原文是可选项。