Pandoc 文档格式转换（默认 Markdown -> DOCX）
当用户需要把 Markdown 转为 Word 文档时，优先使用本技能。该技能基于社区高口碑实践（Pandoc）实现，先保证稳定可用，再兼顾模板化和批量化。
何时使用
- 用户提到：
markdown 转 docx、md 转 word、导出 doc、文档转换。 - 用户要求保留样式、套用公司模板、批量处理多个 Markdown 文件。
- 用户后续希望扩展到
pdf、html等其他输出格式。
默认策略（高分实践）
- 优先使用 Pandoc 官方推荐命令，不自造转换链路。
- 默认目标格式为
docx，输入默认是markdown。 - 若用户提供模板，使用
--reference-doc保持企业样式一致。 - 若用户未指定输出文件名，按输入文件同名生成输出文件。
执行流程
- 参数标准化
- 必填：输入文件路径。
- 选填：输出格式（默认docx）、输出路径、模板路径、是否批量转换。 - 环境检查
- 先执行pandoc --version，若不可用则提示安装：
- Windows:winget install --id JohnMacFarlane.Pandoc -e - 构造命令
- 单文件（默认）：pandoc "input.md" -o "output.docx"- 指定 Markdown 输入类型（可选）：
pandoc -f markdown "input.md" -o "output.docx"- 模板化输出（推荐企业文档）：
pandoc "input.md" -o "output.docx" --reference-doc="template.docx"
- 执行与校验
- 执行转换命令。
- 检查输出文件是否生成且非空。 - 结果反馈
- 返回输出路径、是否使用模板、是否有警告。
可扩展格式路由
将“目标格式”作为第一层分支，保持命令骨架一致：
docx（当前主路径）：pandoc "input.md" -o "output.docx"pdf（扩展路径）：pandoc "input.md" -o "output.pdf"- 若缺少 PDF 引擎，补充
--pdf-engine=xelatex或按环境安装引擎。 html（扩展路径）：pandoc "input.md" -o "output.html"
扩展规则：新增格式时仅增加“格式分支 + 最小必要参数”，不要改动默认 docx 主流程。
批量转换规范
当用户要求批量转换时：
- 先确认输入目录与输出目录。
- 遍历目录下
.md文件，为每个文件生成同名输出。 - 每个文件独立执行转换并记录成功/失败。
- 最终汇总：总数、成功数、失败数、失败文件及原因。
异常处理
- 未安装 Pandoc：明确安装命令，不继续假执行。
- 输入文件不存在：直接报错并返回缺失路径。
- 模板文件不存在：回退为无模板转换，并提示用户。
- 输出格式不支持：提示当前支持格式并建议可扩展项。
输出模板
按以下结构返回给用户：
转换完成。
- 输入: <input>
- 输出: <output>
- 目标格式: <format>
- 模板: <template or 未使用>
- 执行命令: <command>
- 结果: 成功/失败
- 备注: <warning or 无>
