anydoc 使用教程:Word PDF Excel 一键转 Markdown 文档转换 Rust 工具详解

GitHub 1.7万 Star：anydoc
从零部署完整教程 · 新手照着做就能跑起来 · 效率工具指南 · 原创教程

摘要：anydoc 是 GitHub 1.7 万 Star 的开源文档转换工具，Rust 编写，把 Word/PPT/Excel/PDF 等 14 种格式转成干净的 GitHub-Flavored Markdown。本文介绍 npx/pip 安装、以及文档转 Markdown 喂 AI、批量转换、浏览器在线试用等使用方法，附真实转换输出。

想把 Word、PDF 转成干净的 Markdown 喂给 AI？pandoc 转换质量差、LibreOffice 又慢，在线转换还怕文件泄露。anydoc 是一个 Rust 写的开源转换工具，14 种办公文档一键转 Markdown，几毫秒搞定，纯本地不上传。

本文要点

14 种格式（Word/PPT/Excel/PDF 等）→ 干净 Markdown，全覆盖；
Rust 极速，中位转换 <5ms，比 pandoc/LibreOffice 快 100 倍+；
一条命令部署：npx / pip install，无需编译；
纯本地转换不上传，浏览器在线版也能用（WASM）。

一、GitHub 项目数据

项目	数据
Star	17,046（1.7 万）
主要语言	Rust
最新版本	0.1.9
许可证	MIT
支持格式	Word/PPT/Excel/ODF/RTF/EPUB/CSV/PDF（14 种）

二、它能解决什么问题

你的痛点	anydoc 怎么解决
想把 Word/PDF 喂给 AI，但格式乱	转成干净 Markdown，AI 读得懂、不乱码
pandoc/LibreOffice 转换慢、质量差	Rust 极速（<5ms）+ 14 格式评分第一
在线转换怕文件泄露	纯本地转换，文件不出本机
批量文档要转博客/知识库	脚本批量转，一行一个文件

三、安装（一条命令）

① CLI 方式（最方便）：

# 临时用（npx 首次自动下载预编译二进制）npx @firecrawl/anydoc report.docx# 输出到文件npx @firecrawl/anydoc slides.pptx -o slides.md# 永久安装全局命令npm install -g @firecrawl/anydoc

② Python 方式：

pip install firecrawl-anydoc

import anydocmarkdown = anydoc.to_markdown("report.docx")

③ Node.js 方式：npm install @firecrawl/anydoc

④ 浏览器在线试用（零安装）：打开 https://firecrawl.github.io/anydoc/ ，拖入文件即转（WASM 本地转换，不上传）。

四、怎么用（重点）

场景 1：Word 文档转 Markdown 喂给 AI

想让 AI 读懂你的 Word 文档？先转成 Markdown：

npx @firecrawl/anydoc 需求文档.docx -o 需求文档.md

场景 2：PDF 转成文本

提取 PDF 内容（文本 PDF 本地转换，无需 OCR）：

npx @firecrawl/anydoc 论文.pdf -o 论文.md

场景 3：Excel/CSV 转 Markdown 表格

npx @firecrawl/anydoc 数据.xlsx -o 数据.mdnpx @firecrawl/anydoc data.csv -o data.md

场景 4：批量转换

整文件夹文档转 Markdown（写博客/建知识库）：

import anydoc, osfor f in os.listdir('docs'):    if f.endswith(('.docx', '.pdf', '.pptx')):        anydoc.to_markdown(os.path.join('docs', f))

场景 5：让 AI 直接读文档（Agent Skill）

装成 Skill 后，对 Claude Code/Codex 说"读一下这份 docx"：

npx skills add firecrawl/anydoc

场景 6：浏览器拖拽即转

不想装任何东西，打开 https://firecrawl.github.io/anydoc/ 直接拖文件。

五、踩坑记录（实测）

坑 1：pip 安装的包没有 CLI 入口

现象：pip install firecrawl-anydoc 后运行 anydoc 命令报"找不到"。

原因：CLI 是 npm 包（@firecrawl/anydoc），pip 包只是 Python 库。

解决：要命令行用 npx @firecrawl/anydoc；要 Python 调用用 import anydoc。

坑 2：npx 首次运行要下载二进制

现象：第一次 npx 稍慢（在下载预编译二进制）。

原因：npx 需要先拉取 npm 包 + 平台二进制。

解决：属正常，后续秒开；网络慢可先 npm install -g。

六、功能验证（真实输出）

本机实测（Windows + Python 3.12）：CLI 版本 0.1.9 ✅；DOCX → Markdown 标题/段落/表格完整保留：

# 测试文档标题这是第一段测试文字...## 二级标题| 列1 | 列2 || --- | --- || 数据A | 数据B |

CSV → Markdown
中文表格正确 ✅；
PDF → Markdown
文本提取成功 ✅；
纯本地转换，无外部服务 ✅。

七、常见问题

Q1：和 pandoc 比有什么优势？

快 100 倍+（<5ms vs 100ms+），格式覆盖更全（14 种 vs 5 种），转换质量官方基准评分更高（81 vs 56）。

Q2：文件会上传到服务器吗？

不会。转换完全在本地进行；浏览器 demo 也是 WASM 本地转换，不上传。

Q3：扫描版 PDF（图片）能转吗？

文本 PDF 可以本地转换；纯图片扫描版需要 OCR（官方 Firecrawl Parse 云端版提供 OCR，但那是付费 API）。

Q4：没有 Node.js/Python 能用吗？

能。直接用浏览器在线 demo（firecrawl.github.io/anydoc/），拖文件即转，零安装。

八、总结

anydoc 是文档转 Markdown 的最优解：14 种格式全覆盖、Rust 极速、质量最高、纯本地隐私安全。喂 AI、写博客、建知识库、批量转文档——一条命令搞定。如果你经常和办公文档 + AI 打交道，强烈推荐。

命令速查

# 1. CLI（最方便）npx @firecrawl/anydoc 文件.docx            # 转 Markdown 到屏幕npx @firecrawl/anydoc 文件.pptx -o 输出.md  # 输出到文件npm install -g @firecrawl/anydoc           # 永久安装# 2. Pythonpip install firecrawl-anydocpython -c "import anydoc; print(anydoc.to_markdown('文件.docx'))"# 3. 浏览器零安装打开 https://firecrawl.github.io/anydoc/ 拖文件

项目地址：[firecrawl/anydoc] (https://github.com/firecrawl/anydoc)

标签：anydoc、Markdown、文档转换、Word转Markdown、PDF转文本、Rust、效率工具