是什么
「文档转换」封装 pandoc——学术与出版界公认的全能文档转换引擎——把「这份 Word 帮我转成 Markdown」「这几章合成一本 EPUB」变成一句话的事：说清输入输出，AI 组好命令直接执行，转换在本地完成、文件不出机器。
技能调用系统安装的 pandoc（未安装时如实给出 brew/winget 安装引导，装好即用），不打包可执行程序。转换产物落进当前 UUIDE 项目，文件树可见、可直接再编辑。
从单文件格式互换到多文件合并出书，从目录生成到元数据注入，常用路径都有现成模板；Word 模板定制（reference-doc）让产出直接对齐你的排版规范。
核心能力
全格式互转
Markdown、Word（docx）、EPUB、HTML 自由互转；一份源文走遍协作、出版、网页三种世界。
长文合并出书
多章 Markdown 按序合并成一本 EPUB 或 Word，自动生成目录（--toc），书名作者元数据一并注入。
媒体完整保留
Word 转 Markdown 自动抽出内嵌图片（--extract-media）并改写引用，素材直接进资源树。
模板定制
--reference-doc 套用你的 Word 样式模板（字体、标题层级、页边距），产出即符合团队规范。
自动检测
自动检测系统 pandoc，未安装时给出安装引导——轻量技能包，不打包可执行程序。
本地转换
全部转换在本机完成，文档内容不出机器；中文元数据（标题/作者）与 CJK 排版路径都有现成参数。
什么时候会用到
- 「这份 Word 文档帮我转成 Markdown」
- 「把这几章 Markdown 合成一本 EPUB 电子书，要目录」
- 「这篇 Markdown 按公司的 Word 模板排版输出」
- 「把网页内容存成 docx 发给同事」
- 「给这本书加上书名和作者元数据」
- 「这个 docx 里的图片全部抽出来」
不适用于
- PDF 直接排版输出——pandoc 直出 PDF 需 LaTeX（另行安装）；推荐转 HTML 后用 UUIDE 自带导出 PDF
- PDF 转其他格式——PDF 是排版终态，抽取文本走专门工具
- Excel / PPT 转换——pandoc 不覆盖二进制办公格式
- 需要保留 Word 复杂排版（文本框、艺术字、修订）的像素级还原——格式互换语义优先
安装与使用
- 1打开 UUIDE，进入「设置 → 技能」面板，找到本技能点击「安装」
- 2自动检测系统 pandoc：未安装时按提示装一次（brew install pandoc / winget install --id JohnMacFarlane.Pandoc）
- 3会话里说清输入与目标格式即可；产物落当前项目，文件树立即可见、可继续编辑
常见问题
- 需要自己安装 pandoc 吗？
- 需要系统已安装 pandoc（未装时技能给出 brew/winget 安装引导，照做一次即可）。
- 能转 PDF 吗？
- pandoc 直出 PDF 依赖 LaTeX 发行版（体积庞大、另行安装）。推荐路径：先转 HTML 再用 UUIDE 自带的「导出 PDF」，分页与样式由产品控制，效果更稳定。
- Word 转回 Markdown 图片会丢吗？
- 不会。docx 转 Markdown 时加 --extract-media 参数，文档内嵌图片会自动抽到项目媒体目录并改写引用，可直接进资源树。