# Bruce Doc Converter

> Bruce Doc Converter 是一个命令行工具（命令是 bdc），能把 Office、PDF 转成 Markdown，也能把 Markdown 转回 Word，输出结果方便 AI Agent 直接读取。

- 原文：https://bruc3van.com/projects/bruce-doc-converter/
- 作者：Bruce Van
- 分类：文档工作流
- 内容更新：2026-10-03
- 适合谁：想在终端里或者让 Agent 批量整理资料、导出 Word 的人。
- 预期结果：拿到转换好的文件、输出路径和警告信息，再对照原文检查关键内容。

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

## "双向转换"具体指什么？

Bruce Doc Converter 可以在终端里用 `bdc` 命令调用，也可以作为 Agent Skill 让 AI 自己调用。它能把 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
```

命令会输出一段 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/)；想用命令行、要批量处理的结果，或者要 Markdown 转 Word，用 Bruce Doc Converter。完整的写作流程可以看 [AI 文档写作与导出](https://bruc3van.com/playbooks/vibe-writing/)。

## 已有 Markdown，只需要导出 Word 呢？

可以直接看 [bruce-md2word](https://bruc3van.com/projects/bruce-md2word/)。它专注 Markdown 转 Word，提供中文排版、Mermaid 图表转图片和可编辑公式，并支持 Skill、独立 CLI 与 DSH 插件。需要先把 Office 或 PDF 变成 Markdown 时，再使用 Bruce Doc Converter 的资料转换入口。

## 项目文档与使用限制

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

内容更新：2026-10-03。正文依据所列 README 的固定提交整理；内容更新日期不代表已核验最新版本。最新版本与安装要求见项目仓库。

"双向转换"指的是 Office/PDF 转 Markdown、Markdown 转 Word 这两个方向，不能生成 Excel、PowerPoint 或 PDF。扫描版 PDF 要先做文字识别（OCR）。