返回办公与文档场景实践 · 办公与文档

把 Word、PPT、Excel 和 PDF 变成 AI 能读的 Markdown:anydoc 实战

用 Firecrawl 开源的 anydoc 在本地把办公文档统一转换成 Markdown,再让 Codex 在可核对的文本上提取结论、待办与原文依据。

场景实践 · 办公与文档
本篇完成标准

把一份办公文档变成干净 Markdown,再交给 Codex 提取事实。

先完成格式转换和人工检查,再让 AI 总结。第一次练习可以直接在浏览器里完成,不需要写 Rust。

预计用时
约 10 分钟
输入材料
1 份办公文档
最终成果
1 份可核对的 .md
原始文件Word / PPT / Excel / PDF
anydoc统一解析与序列化
中间结果GitHub-Flavored Markdown
交给 AI总结、问答与提取
01
先选路径

只是偶尔转一份文件,先用浏览器;要反复处理,再交给 Codex

anydoc 是 Firecrawl 开源的 Rust 文档转换库,同时提供浏览器、命令行、Node.js、Python 和 Rust 接口。下面三条路径使用同一套转换核心。

最快上手浏览器演示页

拖入文件,页面本地转换,适合先看输出是否符合预期。

从这里开始
推荐工作流Codex + Agent Skill

安装官方 Skill 后,直接让 Codex 转换、保存并检查结果。

查看完整任务
自动化处理CLI / 程序接口

适合批处理和系统集成;CLI 需要 Node.js 20 或更高版本。

查看命令
02
免安装体验

把文件拖进官方演示页,先拿到第一份 Markdown

官方演示页通过 WebAssembly 在当前浏览器中运行。页面声明文件不会离开本机,适合先用一份脱敏材料体验。

anydoc 官方浏览器演示页,可在本地拖入办公文档并转换为 Markdown 打开官方演示页
截图来自 anydoc 官方 WebAssembly 演示页。转换在浏览器本地完成,正式资料仍应遵循所在组织的数据规定。
  1. 1
    准备脱敏文件

    第一次练习选一份结构清楚的 Word、PPT、Excel 或文本型 PDF。

  2. 2
    拖入虚线区域

    等待页面显示 Markdown 预览,再下载或复制结果。

  3. 3
    对照原文检查

    优先检查标题、表格、列表、脚注,以及图片所在位置。

03
进入 Codex 工作流

安装官方 Skill,让 Codex 完成转换和第一轮检查

anydoc 自带兼容 Codex 的 Agent Skill。安装后,把输入和输出路径写清楚,Codex 就能调用 CLI,并按你的验收条件检查结果。

安装官方 Agent Skill在项目终端运行
npx skills add firecrawl/anydoc
完整转换任务替换成你的实际文件路径
请使用 convert-documents-to-markdown Skill 处理这份文件:

输入:./资料/项目周报.docx
输出:./输出/项目周报.md

完成转换后,请先检查:
1. 标题层级是否完整;
2. 表格的行列是否对齐;
3. 是否有图片、扫描页或加密内容没有被转换。

先报告检查结果和输出文件路径,暂时不要总结文档内容。
只想直接使用 CLI

机器上已有 Node.js 20+ 时,下面一条命令会把转换结果写进指定文件;首次运行由 npx 下载预编译包。

npx -y @firecrawl/anydoc "./资料/项目周报.docx" -o "./输出/项目周报.md"
04
格式与输出

8 类办公内容、20 多个扩展名,最后都进入同一个文档模型

官方所说的“14 种格式”指基准测试覆盖的解析格式。实际支持清单按 8 个文档家族组织,并包含多个旧版和宏格式扩展名。

Word.doc · .docx · .docm
PowerPoint.ppt · .pptx · .pps · .pot 等
Excel.xls · .xlsx · .xlsm · .xlsb
OpenDocument.odt · .ods · .odp
RTF.rtf
EPUB.epub
CSV.csv
PDF.pdf(文本型)
统一输出的意义

格式不同,检查方法保持一致

# 标题层级

Word 标题、PPT 页面结构与 EPUB 章节统一进入 Markdown 标题。

| 表格 |

Excel、Word 与 OpenDocument 表格使用同一套转义和序列化逻辑。

- 列表与脚注

编号、嵌套列表、任务项、引用和脚注保留为结构化文本。

05
事实核对

当前官方跑分是 4.4 毫秒中位数,但它不是所有文档的速度承诺

下面是项目 README 在 2026 年 8 月 25 日公开的总表。测试使用 100 份真实文档和 Ryzen 9 9950X3D;不同工具支持的格式数不同,质量总分不能脱离覆盖范围单独比较。

官方 benchmark 摘要格式覆盖、转换中位数与质量分
工具覆盖中位数质量分
anydoc14 / 144.4 ms81
pandoc5 / 14102.1 ms56
markitdown6 / 14134.8 ms65
libreoffice12 / 141129.5 ms40
质量分由 Claude Sonnet 5 盲评完整性、结构、格式与整洁度;语料未随仓库公开,因此它适合判断项目方向,不替代你自己的文档抽样测试。
扫描件需要 OCR

纯图片 PDF 会返回 unsupported。可以改用 Firecrawl Parse,或先经过可信 OCR 流程。

加密文件无法转换

密码保护文档会返回 encrypted,先在受控环境中解密副本再处理。

“本地”仍要做数据判断

浏览器版和本地 CLI 不上传文件,但后续把 Markdown 交给模型时仍受组织的数据规则约束。

06
交给 AI

先限定事实来源,再让 Codex 总结和提取

转换解决的是“能读”和“结构一致”,并不自动保证结论正确。把生成的 Markdown 当作可核对中间层,用下面的任务要求 Codex 给出来源位置。

文档阅读任务转换并抽查完成后发送
请只根据 ./输出/项目周报.md 回答,不补充文档外的事实。

请输出:
1. 这份文档的 5 条核心结论;
2. 所有待办事项、负责人和日期;
3. 信息缺失或前后矛盾的地方;
4. 每条结论对应的原文标题或表格位置。

无法确认的信息标记为“待确认”。
转换完成得到独立 .md 文件
结构抽查标题、表格、列表一致
边界标记图片与缺失页已记录
事实可追溯结论带原文位置
官方来源GitHub 仓库 Benchmark 方法 浏览器演示 扫描件 OCR 路径 本文按 anydoc v0.2.3 与 2026-08-25 官方 README 核对。

本页导航选择要查看的章节