Markdown 转 Word：在线方法、Pandoc 与 DOCX 核验

先按交付任务选择 Markdown 转 DOCX 的方法

你的任务	可以从这里开始	需要核对
临时转换一份文件，不想安装软件	浏览器在线转换	保存后的标题、单元格和链接
用固定流程反复处理多份文档	Pandoc 与自行维护的脚本	输入格式、命令参数和代表性输出
使用指定的 Word 样式	Pandoc 配合参考 DOCX	标题样式、字体和表格外观
交付版面复杂的文档	先转换结构，再在 Word 中调整	分页、浮动图片、合并单元格与页眉

MDFormats 在浏览器中处理文档，但原文引用的远程图片在预览时仍可能发起网络请求。本地处理不等于所有资源都离线。Pandoc 运行在你安装它的环境里，也可能读取外部资源；处理内部文档时，两种方法都要检查图片和链接的来源。

不要仅凭网页预览决定排版是否合格。字体、页面设置和收件人使用的应用，都可能改变换行和分页。

用带编号的小文档建立核对标准

把以下原文以 UTF-8 编码保存为 report.md，或复制到转换工具。表格中的编号用于检查前导零与行列关系；链接只是示例地址，不是真实项目资料。

# 文档交接说明

发出前请核对 **最终稿**。

## 核对记录

| 文档 | 编号 | 状态 |
| --- | --- | --- |
| 使用说明 | DOC-0017 | 已核对 |
| 测试清单 | QA-0023 | 待补充 |

## 发出前

- 保留 Markdown 原稿
- 打开下载的 Word 文件

仅在对应项目中执行 `npm run build`。

[示例文档](https://example.com/docs)

表格连同表头应为三行三列。npm run build 在这里用于核对行内代码，不要求你真的执行。尝试示例时，保留编号、文件名和 Markdown 符号，避免把转换问题与原文修改混在一起。

在浏览器中转换并检查实际 DOCX

1. 打开 Markdown 转 Word，粘贴示例或导入 report.md。
2. 检查预览中的两级标题、表格及两个独立列表项。表格若仍是竖线文本，先修正原文。
3. 使用 DOCX 下载操作并保存文件。
4. 在 Word 或收件人实际使用的兼容应用中打开它。
5. 点击 QA-0023 所在的单元格，尝试修改文字，确认它是表格而不是表格截图。

逐行对照编号和状态，再检查链接地址。表面上整齐的表格，也可能把状态放到了错误行。字体是否好看，可以在内容正确之后再调整。

真实文档的表格过宽时，可缩短重复表头、拆分信息，或在 Word 中调整列宽。Markdown 的对齐标记不等于所有导出器都会保留同样的 Word 对齐方式。

Pandoc 是什么，什么时候值得使用？

Pandoc 是开源的命令行文档转换程序。安装后，在终端指定输入文件和输出格式，就能生成另一种文档。它适合需要重复执行或编写脚本的人；只是转换一份文件时，不必为了使用本站而安装它。

按照官方安装说明安装后，检查版本，再转换同一份原文：

pandoc --version
pandoc report.md -f gfm -t docx -o report.docx

-f gfm 选择 GitHub Flavored Markdown，支持示例使用的竖线表格；-t docx 指定输出格式，-o 后面是保存文件名。在 report.md 所在目录运行，或填写完整路径。提示找不到文件时，应检查路径，不要只重复执行命令。

把版本和命令一起记在团队操作说明里。升级工具或改变原文语法后，用代表性文档重新核对输出。

用参考 DOCX 管理重复使用的样式

Pandoc 可以读取参考 DOCX 的样式和文档属性。先从示例生成一份起始 DOCX，在 Word 中修改相关样式并保存，再执行转换：

pandoc report.md -f gfm -t docx -o reference.docx

在 Word 中打开 reference.docx，修改需要的样式并保存，再运行下一条命令。以后复用这些样式时，不要重新生成并覆盖已经调好的参考文件。

pandoc report.md -f gfm -t docx --reference-doc=reference.docx -o report-styled.docx

参考文件的正文不会被追加到结果中，也不是自动添加封面的方式。可用设置以 Pandoc 的参考文档说明为准。第一次生成后检查标题、字体、表格宽度和分页；命令能重复执行，并不代表版面无需检查。

图片、公式和复杂版面要单独处理

MDFormats 当前生成的 DOCX 不嵌入图片。即使网页预览能显示，仍需在 Word 中补充图片并检查位置；同时保留原图文件。

数学公式按 Markdown 文本导出，不会生成 Word 原生公式。如果需要可编辑的公式，可以在 Word 中创建，或选择已验证支持该记法的其他流程。Pandoc 的格式支持与本站不同，不能把两者的输出能力混为一谈。

复杂合并单元格、浮动图片、页眉页脚和精确分页，也需要在目标应用中复核。Markdown 表达文档结构，不是完整的 Word 页面布局指令。

交付前检查保存后的文档

从开头、中间到末尾检查一遍。对于本页示例，要核对标题层级、三行三列、两个编号、代码文字、链接和末尾段落。修改一个单元格后保存，确认它能满足收件人的编辑需求。

如果同事返回了修改后的 DOCX，可以用 Word 转 Markdown生成后续编辑的草稿。转换后仍要对照返回文件，不能保证往返转换保留所有排版；两份原件都应保留。

常见问题

Word 可以直接打开 MD 文件吗？

读取纯文本与生成 Word 的标题、列表和表格是不同的事。需要结构化、可编辑的文档时，先转换成 DOCX，再打开检查。

使用在线转换器必须安装 Pandoc 吗？

不需要。MDFormats 在浏览器中运行。Pandoc 是需要命令行或参考样式流程时的另一种选择。

DOCX 会和网页预览完全一致吗？

不保证。字体、页面设置和打开文件的应用会影响换行与分页，宽表、图片和公式尤其需要检查。

导出 Word 后还要保存 Markdown 吗？

建议保留。Markdown 用于后续修订，DOCX 供 Word 用户编辑。Markdown 转 Word 的最后一步，是打开保存的文件确认内容，而不只是看到下载成功。