feishu-docx

开源飞书文档导出工具，支持将飞书云文档导出为Markdown格式

GitHub项目文档处理

https://github.com/leemysw/feishu-docx

前往官网

深度报告

feishu-docx 是一个开源的飞书/Lark 云文档导出工具，由开发者 leemysw 创建并维护。该工具支持将飞书文档、表格、多维表格导出为 Markdown 格式，同时提供文档写入能力。核心定位是让 AI Agent 能够直接读写飞书知识库内容，解决手动复制粘贴格式丢失的痛点。项目目前获得 191 个 Star，采用 MIT 许可证开源。
feishu-docx 由个人开发者 leemysw 于 2026 年 1 月创建，在 GitHub 进行开源托管。项目最新版本为 v0.2.5，更新于 2026 年 4 月 11 日。该工具主要面向需要将飞书文档与外部系统集成的技术用户，特别是使用 AI Agent 进行文档处理的开发者群体。随着飞书在企业办公场景的普及，越来越多的团队选择将文档存储在飞书知识库中。然而，无论是人工手动复制文档内容到其他平台，还是让 Claude、Cursor 等 AI Agent 操作飞书内容，都面临格式丢失和效率低下的问题。feishu-docx 正是为了解决这一痛点而诞生的工具型产品。
feishu-docx 提供丰富的文档导出和写入功能，支持多种飞书文档类型的处理。文档导出功能可以将 DocX 文档转换为 Markdown 格式，保留文档的基本结构和格式信息。表格导出功能支持将飞书表格转换为 Markdown 表格，适用于数据分析场景。Bitable（多维表格）导出功能可以将复杂的飞书多维表格导出为结构化的 Markdown 格式。知识库导出功能支持批量导出整个飞书知识库的文档，并保持原有的目录层级结构。文档写入功能允许将 Markdown 内容反向写入飞书文档，实现双向同步。此外还支持微信文章导入导出、浏览器导出、云空间管理、本地资源下载等辅助功能。从使用方式来看，用户可以通过 Python 包方式安装使用，需要 Python 3.11 以上版本。配置时需要提供飞书应用凭证（App ID 和 App Secret），通过飞书开放平台创建企业自建应用并获取相应权限。支持的 AI Agent 平台包括 Claude Code、Cursor、Trae 等主流工具，并提供了专门的 Claude Skill 配置。项目还提供 TUI 终端界面，方便用户交互式操作。与同类工具相比，feishu-docx 的突出优势在于对 AI Agent 的原生支持。项目内置了 Claude Skill，可以直接安装在 Claude Code 或 Cursor 中使用，实现无缝的文档处理流程。同时支持双向导出写入，不仅仅是导出，还能够将外部内容写入飞书文档。
feishu-docx 采用开源免费模式，项目托管在 GitHub 上供免费使用，采用 MIT 许可证。这意味着个人用户和企业用户都可以免费使用该项目，无需支付任何费用。作为工具型开源产品，feishu-docx 目前没有明确的商业变现计划。其价值主要体现在技术便利性和社区贡献上。对于企业用户而言，虽然工具本身免费，但使用时需要具备一定的技术能力来配置飞书应用凭证，企业可能需要投入开发资源进行集成和维护。
从 V2EX 社区的讨论来看，开发者对 feishu-docx 这类工具的需求明确存在。用户在 V2EX 发帖表示，现在很多团队的文档都在飞书里，但不管是自己写脚本还是给 Claude、Cursor 这类 AI Agent 用，飞书内容都不太好读取，feishu-docx 恰好解决了这个问题。技术用户对飞书文档导出工具的典型需求包括：备份知识库文档以防数据丢失、将飞书文档迁移到其他平台、让 AI Agent 能够分析飞书内容进行知识管理等。飞书文档格式转换的难点主要在于飞书文档的复杂格式（包括嵌入的表格、图片、代码块等）在导出时容易丢失，feishu-docx 通过针对飞书 API 的专门处理能够在一定程度上保留文档格式。
飞书文档导出需求在技术社区中具有一定的普遍性。随着飞书、Notion、Notion API 等云文档工具的普及，文档导出和迁移成为常见的工具类需求。目前市场上存在多种飞书文档导出方案，包括 feishu-docx、feishu-doc-export、feishu2md 等开源工具，以及 Cloud Document Converter 等浏览器插件方案。各类方案在功能定位上有所差异：feishu-docx 强调 AI Agent 集成，适合开发工作流自动化；feishu-doc-export 提供更多格式支持（包括 DOCX 和 PDF）；浏览器插件方案则面向技术能力较弱的普通用户。飞书官方也提供了飞书 CLI 开源工具，支持 AI 操作飞书，但更侧重于消息、日历、邮件等场景，文档导出能力不如 feishu-docx 专注。
使用 feishu-docx 需要注意以下风险点：首先，需要在飞书开放平台创建应用并获取凭证，涉及飞书账号权限的授权，用户需要自行评估安全风险；其次，导出文档的格式保留程度受限于飞书 API 的能力，复杂的文档格式可能在导出时有所丢失；此外，作为个人维护的开源项目，未来的功能更新和维护持续性取决于开发者的投入。
feishu-docx 适合以下用户群体：技术开发者需要将飞书文档集成到自动化工作流中；AI Agent 用户需要让 Claude、Cursor 等工具能够读取飞书内容；需要备份飞书知识库的管理员；需要进行文档迁移的用户。对于不需要 AI Agent 集成的普通用户，可以考虑使用 Cloud Document Converter 等浏览器插件方案，操作更简单。对于企业用户，建议评估开源方案的安全性后再决定是否使用，必要时可以联系飞书官方获取企业级的文档集成方案。
feishu-docx 是一款专注于飞书文档导出的开源工具，核心价值在于让 AI Agent 能够直接读写飞书知识库内容，适合技术开发者和工作流自动化场景。免费开源易用是它的主要优势，但复杂的格式保留和长期维护方面需要用户自行评估。对于有飞书文档导出需求的开发者来说，这是一个值得尝试的工具选择。

用户评论

Laura_Flores_202015

—

刚用 feishu-docx 把公司知识库全部导出到本地，格式保留得七七八八，比之前手动复制强太多了。支持 Claude Code 集成确实香。

KimberlyRichardson

—

救命稻草！离职被卡的时候靠它导出了 500+ 文档，救了我的命。

墨染476_1

—

感谢作者，做了个小工具把飞书知识库变成 AI 更容易读写的格式。现在给 Claude 下指令让它读飞书文档方便多了。

CJackson_996

—

比飞书官方 CLI 专注多了，那玩意儿侧重消息和日历，文档导出还是得用 feishu-docx。

暖阳_6

—

yyds！批量导出技能库太方便了，省了我一晚上加班。

PenguinPoolScott

—

装了 Claude Skill 后直接让 AI 帮我写文档，爽飞。

Nicole313

—

用了一段时间，基本能满足需求，就是图片有时会丢希望能出视频教程。

CFlores_66

—

飞书文档转 Markdown 这个需求太小众了，感谢开发者填补空白。

68i7wk

—

免费的开源工具能做到这个程度已经很不错了，要啥自行车。

MarkColeman

—

导出速度感人，700多个文档 25 分钟搞定。

JudithReed_20228

—

搭配 TUI 界面用，比纯命令行友好太多了。

BPerezSr899

—

支持文档写入，这点很实用，不仅仅是导出，还能把外部内容写回飞书。

Natalie_Hughes_2021

—

团队文档全部迁移到本地存档的需求完美解决。

夏轩

—

有技术问题作者回复挺快的，赞一个。

ANguyen_Pro

—

适合需要自动化工作流的团队，个人开发者狂喜。

NoahVeum

—

给作者提了个 issue，没几天就修了，开源精神值得学习。

EagleEdge411

—

配置比想象的简单，按照文档一步步来就行。

biggoose131

—

v0.2.5 更新后 Bitable 导出更稳了。

Jack_AlvarezQ

—

格式保留程度和在飞书里看差不多，满足我的需求。

RPatelK

—

需要先飞书开放平台创建应用获取凭证这一步稍微有点门槛。建议出视频教程。

Virginia.Roberts_Max

—

企业微信文档也能用，意外惊喜。

PhilipSanders_2021

—

支持 Cursor 集成太香了，代码和文档一起管理。

GMurray_2021

—

备份和迁移用这个工具效率提升明显，推荐。

月光635

—

MIT 协议商用无忧，白票党狂喜。

JEdwards_2021

—

文档写入功能太香了！把本地 md 文件同步到飞书知识库，整个流程自动化。

LI0QS

—

复杂表格格式有时会丢失，建议导出后再手动检查一遍。

eyritb1rsb007

—

适合 DevOps 和知识管理场景，已经安利给团队了。

DorothyReed_2020

—

感谢作者开源，比收费的还好用。

Bobby_Vasquez2

—

多维表格导出后格式居然保留了，感动！

NFTCollector357

—

个人维护的项目，能感觉到在认真做，期待更多功能。

feishu-docx

深度报告

用户评论

相关链接

同类产品