Export Feishu/Lark cloud documents to Markdown. Supports docx, sheets, bitable, and wiki. Use this skill when you need to read, analyze, or reference content from Feishu knowledge base.
npxskills add leemysw/feishu-docx--skill feishu-docxLoading…
Export Feishu/Lark cloud documents to Markdown for AI analysis, writing, and automation.
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.
Optional features are split into extras so the core install stays lightweight. Quote extras in zsh and similar shells.
export-browser requires Playwright and a Chromium runtime:
pip install 'feishu-docx[browser]'
playwright install chromium
PDF export requires the pdf extra:
pip install 'feishu-docx[pdf]'
feishu-docx export "<FEISHU_URL>" -o ./output
The exported Markdown file will be saved with the document's title as filename.
If the document is public or only readable in your current browser session, prefer:
feishu-docx export-browser "<FEISHU_OR_LARK_URL>" -o ./output
Or reuse an existing Playwright session:
feishu-docx export-browser "<FEISHU_OR_LARK_URL>" --storage-state ./storage_state.json
| Command | Description |
|---|---|
feishu-docx export <URL> | Export document to Markdown |
feishu-docx export <URL> --pdf | Export document to Markdown and PDF |
feishu-docx export-browser <URL> | Export in a real browser session with local assets |
feishu-docx export-wechat <URL> | Export WeChat article to Markdown |
feishu-docx create <TITLE> | Create new document |
feishu-docx create --url <URL> | Create document from WeChat article |
feishu-docx write <URL> | Append content to document |
feishu-docx update <URL> | Update specific block |
feishu-docx drive ls | List app or personal cloud-space files |
feishu-docx drive perm-show <TOKEN> | Show public permission |
feishu-docx drive perm-members <TOKEN> | List permission members |
feishu-docx drive clear | Clear files with double confirmation |
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 |
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -o ./docs
feishu-docx export "https://xxx.feishu.cn/docx/XYZ789" -o ./docs -n meeting_notes
feishu-docx export-browser "https://xxx.larkoffice.com/wiki/ABC123" -o ./browser_docs
feishu-docx export "https://xxx.feishu.cn/docx/XYZ789" --pdf
# 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
# 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
# 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 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
# 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
# Create from a WeChat article URL
feishu-docx create --url "https://mp.weixin.qq.com/s/xxxxx"
如何获取 folder token:
https://xxx.feishu.cn/drive/folder/fldcnXXXXXXfldcnXXXXXX 就是 folder token# 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
# List app cloud-space documents
feishu-docx drive ls --auth-mode tenant --type docx
# List personal cloud-space documents
feishu-docx drive ls --auth-mode oauth --type docx
# Show public permission
feishu-docx drive perm-show "https://xxx.feishu.cn/docx/ABC123"
# List permission members
feishu-docx drive perm-members "https://xxx.feishu.cn/docx/ABC123"
# Clear files with double confirmation
feishu-docx drive clear --type docx
# 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
-bto get block IDs- Find the target block ID from HTML comments
- Use
feishu-docx updatewith that block ID
{doc_title}/ folder when local assets are availableexport-browser for public share links or browser-readable docs--stdout or -c for direct content output (recommended for agents)-b to export with block IDs for later updates--lark flagtenant_access_token manages app cloud space, user_access_token manages personal cloud space
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).