Markdown导出Word论文：Pandoc命令、模板边界与验收清单

已有 Markdown 论文时，默认先走本地 Pandoc。这样可以继续把 .md 作为源文件，修改后重复生成 DOCX。但转换命令无法补全学校或期刊对 Word 文档的全部要求：Markdown 可以记录标题、段落、图片链接、公式和引文键，却通常不包含纸张、页边距、字体、行距、页眉页脚、题注及参考文献样式。

因此，第一步不是运行转换，而是列出目标 Word 文档的交付要求。没有明确要求时，Pandoc 只能生成待检查的 DOCX，不能替作者判断其是否符合交付要求。Pandoc 官方手册也说明，格式转换以保留文档结构为主，不应期待不同格式之间无损互转。

Markdown 缺少哪些 Word 目标信息

信息	主要来源
章节、段落、列表、图片和公式	Markdown 正文
稿件标题、作者、摘要	Markdown YAML 元数据
字体、字号、行距和标题样式	`reference.docx`
纸张、页边距、页眉页脚	`reference.docx` 的文档属性
引文和文后参考文献格式	CSL 样式
封面、分节及特殊声明	自定义模板或导出后处理
分页和软件兼容性	Word/WPS 实际验收

文档标题不要只写成正文中的一级标题。可以在 paper.md 开头保留最小元数据，例如：

---
title: 示例论文
author: 示例作者
---

其中 title 是稿件标题，正文中的 #、##、### 用于章节层级。

转换前的最小预检

先完成三项检查：

运行 pandoc --version，确认终端能够找到 Pandoc，并记录实际版本。
用 cd "论文项目目录" 进入存放论文的目录。引号中的路径是占位示例，应换成当前系统上的真实路径。
确认当前目录中存在实际输入文件 paper.md 和已经定制好的 custom-reference.docx。找不到任一文件时先停止转换并修正路径。

如果还没有 custom-reference.docx，首次创建时可运行下面这条单行命令；已有定制文件时不要直接覆盖：

pandoc -o "custom-reference.docx" --print-default-data-file reference.docx

随后在 Word 或 LibreOffice 中修改 Pandoc 实际使用的样式，如 Body Text、First Paragraph、Heading 1、Bibliography、Image Caption 和 Table。

--reference-doc 不会把论文填进一个现成的学校模板。参考文件中的正文内容会被忽略，Pandoc 只复用样式表和文档属性，包括页边距、纸张、页眉与页脚。因此，写在学校模板正文里的封面文字和声明页不会自动进入结果文件，自定义的“三线表”等样式也不会仅凭名称自动绑定。

先生成一份不含文献处理的 DOCX

如果正文没有 [@citekey] 引文，先使用下面这条跨平台单行命令：

pandoc "paper.md" --from=markdown+tex_math_dollars --to=docx --output="thesis_to_review.docx" --reference-doc="custom-reference.docx"

这里的输入、参考文件和输出路径都是示例。实际文件不在当前目录时，应换成正确的相对路径或绝对路径，并继续用引号包住含空格的路径。

只有交付要求包含目录时，才在上述命令末尾增加 --standalone --toc --toc-depth=3，以生成包含一至三级标题的目录；不需要目录时不要添加这些参数。生成后仍要在 Word/WPS 中检查目录字段和页码是否更新。

Pandoc 默认以运行命令时的工作目录为基准查找图片。在论文目录中执行命令，并保持 Markdown 中 images/chart.png 一类相对路径有效，通常最简单。如果需要额外搜索图片目录，Unix 或 macOS 可使用 --resource-path=".:images"，Windows 可使用 --resource-path=".;images"。终端出现缺图警告时，应先修正路径，不能把缺少图片的 DOCX 当成交付稿。

单独成段且具有非空说明文字的 Markdown 图片可以被识别为 figure；行内图片、空说明或特殊 HTML 写法的结果可能不同。题注位置、编号、尺寸和清晰度仍需在成稿中检查。

正文有引文时再启用 Citeproc

只有在正文确实使用 [@citekey]，并且实际的 BibTeX 与 CSL 文件都存在时，才运行完整引用命令：

pandoc "paper.md" --from=markdown+tex_math_dollars --to=docx --output="thesis_to_review.docx" --reference-doc="custom-reference.docx" --citeproc --bibliography="references.bib" --csl="target-style.csl"

paper.md、custom-reference.docx、references.bib 和 target-style.csl 都是路径示例，应换成当前项目中的真实文件。CSL 应按学校或期刊要求选择，可在 Zotero Style Repository 中核对，不能把任一具体样式当作所有论文的默认答案。

--citeproc 会按照 CSL 渲染正文引文并生成文后参考文献。生成结果中的引文不是可由 Zotero 继续刷新或切换样式的动态字段。修改引文键、BibTeX 或 CSL 后，应回到源文件重新运行 Pandoc。

OMML 公式的适用边界

$...$ 和 $$...$$ 中的 TeX 数学内容，在 DOCX 中会由 Pandoc 输出为 OMML。这能保留 Word 数学结构，但不保证所有 LaTeX 写法都能正确转换。

自定义宏、依赖额外宏包的命令、复杂对齐环境、公式编号和交叉引用尤其需要检查。如果编号或交叉引用缺失、错位或无法更新，应停止交付，并从以下方案中选择一种：

调整源文件，改成 Pandoc 能明确识别的公式写法；
采用已经选定并验证过的 Pandoc 扩展或过滤器，再从源文件重新生成；
明确把编号和交叉引用作为 DOCX 导出后的处理步骤，并重新完成验收。

问题未修复前，不应仅因公式外观看似正常就提交文件。

Word/WPS 交付验收清单

核对对象	必查内容
页面与稿件信息	纸张、页边距、页眉页脚、页码、分节、封面、作者、机构和摘要位置
标题与目录	各级章节是否为正确的 Word 标题样式；导航窗格是否完整；目录是否更新；稿件标题是否重复
图片与图题	图片是否齐全清晰；尺寸、裁切、题注位置、编号、来源说明和正文引用是否正确
表格	是否超出页面；表头、边框、对齐、分页和来源说明是否保留
数学公式	是否残留 TeX 源码；矩阵、上下标、符号、编号和交叉引用是否正确；是否能按需要编辑
引文与参考文献	是否有未解析的引文键；正文与文后一一对应；顺序、标点、作者著录与省略规则、DOI/URL 和缩进是否符合目标样式
最终文件	保存、关闭并重新打开 DOCX；在实际提交所用的 Word 或 WPS 中检查字体替换、分页和打印预览

导航窗格正常不代表整篇格式已经合格，参考文献列表看似完整也不代表著录信息正确。验收应对照学校或期刊的真实要求，而不是只检查文件能否打开。

什么时候考虑 InkFount

希望继续维护现有 Markdown 时，Pandoc 通常更直接。只有在愿意在可视化编辑器中重建稿件，并且 InkFount 当前模板面板确实为稿件语言提供 Word 导出格式时，才适合考虑 InkFount 编辑器。

InkFount 当前没有公开的 Markdown 文件上传导入或 AI 自动转换入口。将内容重新录入编辑器后，需要按照编辑器基础说明重新确认标题、作者、机构、摘要和一至三级章节标题；图片、表格、单行 LaTeX 公式及交叉引用需按图表与公式帮助重新建立；文献则通过搜索、手动添加或逐条导入 BibTeX，再插入正文引用。

模板导出面向登录用户的云端稿件。可用语言、模板和 Word 格式以当前导出面板实际显示为准，不能把未显示的学校模板或格式当作现有能力。下载后仍需执行同一份 Word/WPS 验收清单。

Pandoc 适合保留 Markdown 源文件并控制本地转换链；InkFount 适合在现有模板覆盖目标要求时，通过可视化界面重新管理文档结构、图表、公式和文献。两条路径生成的都是需要检查的成稿候选，不能代替最终交付验收。