Feishu Docx Exporter

Export Feishu/Lark cloud documents to Markdown format for AI analysis.

Setup (One-time)

bash

pip install feishu-docx
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

Token auto-refreshes. No user interaction required.

Export Documents

bash

feishu-docx export "<FEISHU_URL>" -o ./output

The exported Markdown file will be saved with the document's title as filename.

Supported Document Types

docx: Feishu cloud documents → Markdown with images
sheet: Spreadsheets → Markdown tables
bitable: Multidimensional tables → Markdown tables
wiki: Knowledge base nodes → Auto-resolved and exported

Command Reference

Command	Description
`feishu-docx export <URL>`	Export document to Markdown
`feishu-docx create <TITLE>`	Create new document
`feishu-docx write <URL>`	Append content to document
`feishu-docx update <URL>`	Update specific block
`feishu-docx export-wiki-space <URL>`	Batch export entire wiki space
`feishu-docx export-workspace-schema <ID>`	Export bitable database schema
`feishu-docx auth`	OAuth authorization
`feishu-docx config set`	Set credentials
`feishu-docx config show`	Show current config
`feishu-docx config clear`	Clear token cache
`feishu-docx tui`	Interactive TUI interface

Examples

Export a wiki page

bash

feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -o ./docs

Export a document with custom filename

bash

feishu-docx export "https://xxx.feishu.cn/docx/XYZ789" -o ./docs -n meeting_notes

Read content directly (recommended for AI Agent)

bash

# Output content to stdout instead of saving to file
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" --stdout
# or use short flag
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -c

Export with Block IDs (for later updates)

bash

# Include block IDs as HTML comments in the Markdown output
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" --with-block-ids
# or use short flag
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -b

Batch Export Entire Wiki Space

bash

# Export all documents in a wiki space (auto-extract space_id from URL)
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./wiki_backup

# Specify depth limit
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./docs --max-depth 3

# Export with Block IDs for later updates
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./docs -b

Export Database Schema

bash

# Export bitable/workspace database schema as Markdown
feishu-docx export-workspace-schema <workspace_id>

# Specify output file
feishu-docx export-workspace-schema <workspace_id> -o ./schema.md

Write Documents (CLI)

Create Document

bash

# Create empty document
feishu-docx create "我的笔记"

# Create with Markdown content
feishu-docx create "会议记录" -c "# 会议纪要\n\n- 议题一\n- 议题二"

# Create from Markdown file
feishu-docx create "周报" -f ./weekly_report.md

# Create in specific folder
feishu-docx create "笔记" --folder fldcnXXXXXX

如何获取 folder token:

在浏览器中打开目标文件夹

从 URL 中提取 token：

https://xxx.feishu.cn/drive/folder/fldcnXXXXXX

```
fldcnXXXXXX
```
就是 folder token

Append Content to Existing Document

bash

# Append Markdown content
feishu-docx write "https://xxx.feishu.cn/docx/xxx" -c "## 新章节\n\n内容"

# Append from file
feishu-docx write "https://xxx.feishu.cn/docx/xxx" -f ./content.md

Update Specific Block

bash

# Step 1: Export with Block IDs
feishu-docx export "https://xxx.feishu.cn/docx/xxx" -b -o ./

# Step 2: Find block ID from HTML comments
# <!-- block:blk123abc -->
# # Heading
# <!-- /block -->

# Step 3: Update the specific block
feishu-docx update "https://xxx.feishu.cn/docx/xxx" -b blk123abc -c "新内容"

Tip for AI Agents: When you need to update a specific section:
Export with
-b
to get block IDs
Find the target block ID from HTML comments
Use
feishu-docx update
with that block ID

Tips

Images auto-download to
```
{doc_title}/
```
folder
Use
```
--stdout
```
or
```
-c
```
for direct content output (recommended for agents)
Use
```
-b
```
to export with block IDs for later updates
Token auto-refreshes, no re-auth needed
For Lark (overseas): add
```
--lark
```
flag

feishu-docx

NPX Install

SKILL.md Content

Feishu Docx Exporter

Setup (One-time)

Export Documents

Supported Document Types

Command Reference

Examples

Export a wiki page

Export a document with custom filename

Read content directly (recommended for AI Agent)

Export with Block IDs (for later updates)

Batch Export Entire Wiki Space

Export Database Schema

Write Documents (CLI)

Create Document

Append Content to Existing Document

Update Specific Block

Tips