# Bruce Doc Converter

> Bruce Doc Converter 是面向 Agent 的文档转换 CLI，支持 Office/PDF 转 Markdown，以及 Markdown 转 Word，使用 bdc 命令输出结构化结果。

- 原文：https://bruc3van.com/projects/bruce-doc-converter/
- 作者：Bruce Van
- 分类：文档工作流
- 更新日期：2026-09-06
- 适合谁：希望在终端或 Agent 工作流中批量整理资料、导出 Word 的用户。
- 预期结果：获得转换文件、输出路径和警告信息，并按原文检查关键内容。

- [GitHub 源码](https://github.com/bruc3van/bruce-doc-converter)
- [相关指南](https://bruc3van.com/playbooks/vibe-writing/)

## 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`，然后先查看帮助并处理一份样本：

```sh
bdc --help-json
bdc convert /path/to/document.docx
```

CLI 的标准输出是结构化 JSON，可读取成功状态、输出路径和警告。批量任务需检查每个文件的结果，不能只看是否生成了某个文件。

## Markdown 导出 Word 需要额外准备什么？

Markdown → Word 使用 Node.js 依赖，首次使用需要显式初始化：

```sh
bdc setup-node
bdc convert /path/to/notes.md
```

正文包含 Mermaid 时还需要可用的浏览器用于渲染。转换时默认优先使用本地浏览器；缺少浏览器时，可以按安装说明单独安装。

## 哪些内容需要人工检查？

- 表格中的数值、合并关系和单位。
- 标题、列表与图片是否仍对应原文。
- PDF 是否有可提取的文本；扫描型文件通常需要先 OCR。
- 导出的 Word 是否分页合理，图表是否清楚。

## 与 DocuGenius 怎么选？

习惯在编辑器右键转换资料，可以先看 [DocuGenius](https://bruc3van.com/projects/docugenius/)；需要 CLI、批量结果或 Markdown → Word，则可使用 Bruce Doc Converter。完整写作流程见 [AI 文档写作与导出](https://bruc3van.com/playbooks/vibe-writing/)。

## 项目文档与使用限制

- [项目 README](https://github.com/bruc3van/bruce-doc-converter/blob/4ec1dcbd9386cbf09ece6f3e023c1e821754a7c8/README.md)

内容更新：2026-09-06。最新版本与安装要求见项目仓库。

双向转换指 Office/PDF 转 Markdown 和 Markdown 转 Word，不表示可生成 Excel、PowerPoint 或 PDF。扫描 PDF 需先 OCR。