适合谁
希望在终端或 Agent 工作流中批量整理资料、导出 Word 的用户。
预期结果
获得转换文件、输出路径和警告信息，并按原文检查关键内容。
Bruce Doc Converter 的“双向转换”指什么？
Bruce Doc Converter 提供 bdc 命令行入口，也可以由 Agent Skill 编排。它支持把 Word、Excel、PowerPoint 和 PDF 转为 Markdown，以及将 Markdown 导出为 Word。
| 输入 | 输出 |
|---|---|
| DOCX、XLSX、PPTX、PDF | Markdown |
| Markdown | DOCX |
不应将这张格式表理解为任意 Office 格式之间互转。旧版 .doc、.xls 和 .ppt 需要先转换为受支持的新格式。
如何转换第一份文档？
按照仓库当前安装说明准备 bdc，然后先查看帮助并处理一份样本：
bdc --help-json
bdc convert /path/to/document.docxCLI 的标准输出是结构化 JSON，可读取成功状态、输出路径和警告。批量任务需检查每个文件的结果，不能只看是否生成了某个文件。
Markdown 导出 Word 需要额外准备什么？
Markdown → Word 使用 Node.js 依赖，首次使用需要显式初始化：
bdc setup-node
bdc convert /path/to/notes.md正文包含 Mermaid 时还需要可用的浏览器用于渲染。转换时默认优先使用本地浏览器；缺少浏览器时，可以按安装说明单独安装。
哪些内容需要人工检查？
- 表格中的数值、合并关系和单位。
- 标题、列表与图片是否仍对应原文。
- PDF 是否有可提取的文本；扫描型文件通常需要先 OCR。
- 导出的 Word 是否分页合理，图表是否清楚。
与 DocuGenius 怎么选？
习惯在编辑器右键转换资料，可以先看 DocuGenius；需要 CLI、批量结果或 Markdown → Word，则可使用 Bruce Doc Converter。完整写作流程见 AI 文档写作与导出。
项目文档与使用限制
项目文档：项目 README
内容更新：。最新版本与安装要求见项目仓库。
使用限制：双向转换指 Office/PDF 转 Markdown 和 Markdown 转 Word，不表示可生成 Excel、PowerPoint 或 PDF。扫描 PDF 需先 OCR。