# DocuGenius

> DocuGenius 是在 VS Code 类编辑器中将 Word、Excel、PowerPoint 和 PDF 转为 Markdown 的扩展，支持单文件与文件夹批量转换。

- 原文：https://bruc3van.com/projects/docugenius/
- 作者：Bruce Van
- 分类：文档工作流
- 更新日期：2026-09-06
- 适合谁：需要在编辑器中整理 Office、PDF 资料，并交给 AI 编程工具引用的用户。
- 预期结果：在本地得到 Markdown 与提取的图片，再抽查结构和数据后用于后续工作。

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

## 如何让 AI 编程工具读取 Office 文档？

DocuGenius 将 Office 与 PDF 资料转换为 Markdown，再由编辑器或 AI 工具引用生成的文件。它专注文档转换，不提供原始 Office 或 PDF 的阅读器功能。

支持的输入包括 `.docx`、`.xlsx`、`.pptx` 和 `.pdf`；结果包含文本结构、表格，以及能够提取的图片。

## 在编辑器中怎么使用？

1. 在 VS Code 类编辑器的扩展市场搜索 DocuGenius，或按照仓库说明从发布包安装。
2. 对一份样本文档点击右键，选择 `[DocuGenius] Convert to Markdown`。
3. 在生成的 `DocuGenius/` 目录中查看 Markdown 和图片。
4. 抽查标题层级、表格数值与图片位置，再引用到 AI 对话。
5. 单文件结果符合预期后，可对文件夹使用 `[DocuGenius] Process All Files in Folder`。

## macOS 与 Windows 有什么不同？

macOS 发布包内置运行组件；Windows 首次转换需要可用的 Python，并引导安装扩展自己的共享运行时。后续工作区复用这套运行时。

遇到 Windows 依赖问题时，可以通过 Show Runtime Status 查看状态，再按需要使用 Install Shared Runtime 或 Repair Shared Runtime 安装、修复共享运行时。

## 本地转换等于不会发送数据吗？

本地转换阶段与后续 AI 问答应分开看。转换工具在本机处理文档，但如果把生成内容交给云端模型，数据仍可能发送到模型服务。使用前先决定哪些资料可以用于外部服务。

## 需要把 Markdown 再导出成 Word 怎么办？

DocuGenius 的重点是资料转入 Markdown。若需要 Markdown → Word，可以使用 [Bruce Doc Converter](https://bruc3van.com/projects/bruce-doc-converter/)，并在 Word 或 WPS 中复核成品。

## 项目文档与使用限制

- [项目 README](https://github.com/bruc3van/DocuGenius/blob/73cc3774ac45d737d9d68a19a4c14d1663577e34/README.md)

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

文档转换在本地执行；后续向云端 AI 提问是另一条数据路径。复杂排版与扫描 PDF 需要另行检查。