Pandoc Markdown 转 Word

解决的问题

把 Markdown 交付成可编辑的 Word 文档时，常见麻烦不是“能不能转”，而是输出是否保留标题层级、列表、代码块、表格等结构，以及能否套用企业模板。pandoc-doc-convert 针对这一类问题，默认以 markdown 作为输入、docx 作为输出，优先使用 Pandoc 的稳定转换链路，减少自研解析或复杂导出脚本带来的格式漂移。

工作方式

该技能按“参数标准化、环境检查、命令构造、执行校验、结果反馈”的流程处理请求：

• 单文件转换：输入 input.md，默认生成同名 output.docx。
• 模板化输出：用户提供模板时，使用 --reference-doc 让正文沿用企业样式，而不是只生成一个裸 Word 文件。
• 批量转换：确认输入目录与输出目录后，遍历 .md 文件，逐个转换并汇总成功、失败数量及原因。
• 格式扩展：在保持主命令骨架不变的前提下，可按需路由到 pdf 或 html 输出；PDF 路径可能需要额外引擎支持。
• 异常处理：输入文件缺失、模板不存在或输出格式不支持时，会明确返回问题点，而不是静默生成不完整结果。

适用边界

它适合团队把 Markdown 写作结果转成可评审、可编辑的 Word 文档，尤其适合已有固定模板的场景。需要注意：该技能的核心目标是稳定完成文档转换，不是重新排版复杂出版内容，也不保证所有 Pandoc 扩展语法都能得到理想 Word 效果；若目标格式依赖特定 PDF 引擎或样式系统，仍需提前确认环境可用。