feishu-docx

The open source Feishu document export tool supports exporting Feishu Cloud documents to Markdown format.

GitHub project Document processing

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

Visit Website

In-depth Report

feishu-docx is an open source Feishu/Lark cloud document export tool created and maintained by developer leemysw. This tool supports exporting Feishu documents, tables, and multi-dimensional tables to Markdown format, and also provides document writing capabilities. The core positioning is to enable AI Agents to directly read and write Feishu knowledge base content, solving the pain point of manual copy and paste format loss. The project currently has 191 stars and is open source under the MIT license.
feishu-docx was created by individual developer leemysw in January 2026 and is open source hosted on GitHub. The latest version of the project is v0.2.5, updated on April 11, 2026. This tool is mainly aimed at technical users who need to integrate Feishu documents with external systems, especially the developer group who use AI Agent for document processing. As Feishu becomes more popular in corporate office scenarios, more and more teams choose to store documents in Feishu's knowledge base. However, whether you manually copy the document content to other platforms, or let Claude, Cursor and other AI agents operate Feishu content, you still face the problem of format loss and low efficiency. feishu-docx is a tool product born to solve this pain point.
feishu-docx provides rich document export and writing functions and supports the processing of multiple Feishu document types. The document export function can convert DocX documents into Markdown format, retaining the basic structure and format information of the document. The table export function supports converting Feishu tables into Markdown tables, which is suitable for data analysis scenarios. The Bitable (multidimensional table) export function can export complex Feishu multidimensional tables into structured Markdown format. The knowledge base export function supports batch export of documents of the entire Feishu knowledge base and maintains the original directory hierarchy. The document writing function allows Markdown content to be written in reverse to Feishu documents, achieving two-way synchronization. In addition, it also supports auxiliary functions such as WeChat article import and export, browser export, cloud space management, and local resource download. From the perspective of usage, users can install and use it through the Python package method, which requires Python 3.11 or above. When configuring, you need to provide Feishu application credentials (App ID and App Secret), create enterprise-built applications through the Feishu open platform, and obtain corresponding permissions. Supported AI Agent platforms include mainstream tools such as Claude Code, Cursor, and Trae, and provide specialized Claude Skill configuration. The project also provides a TUI terminal interface to facilitate user interactive operations. Compared with similar tools, the outstanding advantage of feishu-docx is its native support for AI Agent. The project has built-in Claude Skill, which can be directly installed and used in Claude Code or Cursor to achieve a seamless document processing process. It also supports bidirectional export and writing, not only exporting, but also writing external content to Feishu documents.
feishu-docx adopts an open source free model. The project is hosted on GitHub for free use and adopts the MIT license. This means that both individual and enterprise users can use the project for free without paying any fees. As a tool-based open source product, feishu-docx currently has no clear commercial monetization plan. Its value is mainly reflected in technical convenience and community contribution. For enterprise users, although the tool itself is free, it requires certain technical capabilities to configure Feishu application credentials, and enterprises may need to invest development resources for integration and maintenance.
Judging from discussions in the V2EX community, developers clearly have a need for tools like feishu-docx. A user posted on V2EX that many teams' documents are now in Feishu, but whether they write scripts themselves or use them for AI agents such as Claude and Cursor, Feishu content is not easy to read. feishu-docx solves this problem. Typical needs of technical users for Feishu document export tools include: backing up knowledge base documents to prevent data loss, migrating Feishu documents to other platforms, allowing AI Agents to analyze Feishu content for knowledge management, etc. The main difficulty in converting Feishu document formats is that the complex formats of Feishu documents (including embedded tables, pictures, code blocks, etc.) are easily lost during export. Feishu-docx can preserve the document format to a certain extent through specialized processing of the Feishu API.
Feishu document export requirements are somewhat common in the technical community. With the popularity of cloud document tools such as Feishu, Notion, and Notion API, document export and migration have become common tool requirements. There are currently a variety of Feishu document export solutions on the market, including open source tools such as feishu-docx, feishu-doc-export, feishu2md, and browser plug-in solutions such as Cloud Document Converter. Various solutions differ in functional positioning: feishu-docx emphasizes AI Agent integration and is suitable for development workflow automation; feishu-doc-export provides more format support (including DOCX and PDF); the browser plug-in solution is aimed at ordinary users with weak technical capabilities. Feishu officially also provides the Feishu CLI open source tool, which supports AI operations on Feishu, but it focuses more on messaging, calendar, email and other scenarios. The document export capability is not as focused as feishu-docx.
When using feishu-docx, you need to pay attention to the following risks: First, you need to create an application on the Feishu open platform and obtain credentials, which involves the authorization of Feishu account permissions. Users need to evaluate the security risks by themselves; secondly, the format retention of exported documents is limited by the capabilities of Feishu API, and complex document formats may be lost during export; in addition, as an open source project maintained by individuals, future function updates and maintenance continuity depend on the input of developers.
feishu-docx is suitable for the following user groups: technology developers who need to integrate Feishu documents into automated workflows; AI Agent users who need to enable tools such as Claude and Cursor to read Feishu content; administrators who need to back up Feishu knowledge base; users who need to migrate documents. For ordinary users who do not need AI Agent integration, you can consider using browser plug-in solutions such as Cloud Document Converter, which makes the operation easier. For enterprise users, it is recommended to evaluate the security of the open source solution before deciding whether to use it. If necessary, you can contact Feishu official to obtain an enterprise-level document integration solution.
feishu-docx is an open source tool focused on Feishu document export. Its core value lies in allowing AI Agents to directly read and write Feishu knowledge base content, making it suitable for technology developers and workflow automation scenarios. Free, open source and easy to use is its main advantage, but complex format retention and long-term maintenance require users to evaluate themselves. For developers who need to export Feishu documents, this is a tool worth trying.

User Reviews

Laura_Flores_202015

—

I just used feishu-docx to export all the company's knowledge base to the local, and the format is preserved, which is much better than manual copying before. Supporting Claude Code integration is really cool.

KimberlyRichardson

—

Life-saving straw! When I was stuck after leaving my job, I relied on it to export 500+ documents, which saved my life.

墨染476_1

—

Thanks to the author, he made a small tool to transform the Feishu knowledge base into a format that is easier for AI to read and write. Now it is much easier to give Claude instructions to read Feishu documents.

CJackson_996

—

It is much more focused than the official CLI of Feishu. It focuses on messages and calendars, and you still need to use feishu-docx to export documents.

暖阳_6

—

yyds! Exporting skill libraries in batches is so convenient and saves me a whole night of overtime work.

PenguinPoolScott

—

After installing Claude Skill, I can directly ask AI to write documents for me, which is great.

Nicole313

—

After using it for a while, it can basically meet the needs, but sometimes the pictures are lost. I hope there will be a video tutorial.

CFlores_66

—

The demand for converting Feishu documents to Markdown is too niche. Thank you to the developers for filling the gap.

68i7wk

—

It’s pretty good that free open source tools can achieve this level, so what kind of bike do you need?

MarkColeman

—

The export speed is impressive, with more than 700 documents completed in 25 minutes.

JudithReed_20228

—

Used with the TUI interface, it is much more friendly than the pure command line.

BPerezSr899

—

It supports document writing, which is very practical. It not only exports, but also writes external content back to Feishu.

Natalie_Hughes_2021

—

The need to migrate all team documents to local archives is perfectly solved.

夏轩

—

If you have technical questions, the author responds very quickly. Thumbs up.

ANguyen_Pro

—

Suitable for teams that need to automate workflow, and individual developers are ecstatic.

NoahVeum

—

I raised an issue with the author and it was fixed within a few days. The open source spirit is worth learning.

EagleEdge411

—

The configuration is simpler than imagined, just follow the documentation step by step.

biggoose131

—

After the v0.2.5 update, Bitable export is more stable.

Jack_AlvarezQ

—

The format retention is similar to that seen on Feishu, which meets my needs.

RPatelK

—

You need to first create an application on the Feishu Open Platform to obtain the credentials. This step is a bit difficult. Recommend a video tutorial.

Virginia.Roberts_Max

—

Corporate WeChat documents can also be used, which is an unexpected surprise.

PhilipSanders_2021

—

Supporting Cursor integration is great, and code and documents are managed together.

GMurray_2021

—

The efficiency of backup and migration is significantly improved with this tool, which is recommended.

月光635

—

The commercial use of the MIT protocol is worry-free, and the vote-free party is ecstatic.

JEdwards_2021

—

The document writing function is so cool! Synchronize local md files to Feishu knowledge base and automate the entire process.

LI0QS

—

Complex table formats are sometimes lost, so it is recommended to check them manually after exporting.

eyritb1rsb007

—

It is suitable for DevOps and knowledge management scenarios and has been provided to the team.

DorothyReed_2020

—

Thanks to the author for open source, it is easier to use than the paid version.

Bobby_Vasquez2

—

The format of the multi-dimensional table was actually retained after exporting it, I was touched!

NFTCollector357

—

For personal maintenance projects, I can feel that they are being done seriously, and I look forward to more functions.

feishu-docx

In-depth Report

User Reviews

Similar Products