Lark To Anything

lark-to-anything: Feishu Doc → Local Markdown

Export any Feishu document to a self-contained local folder: /index.md + /assets/ with all images downloaded.

Prerequisites

Read ../lark-shared/SKILL.md for auth and global flags before running any lark-cli command.

Steps

0. Check lark-cli version

lark-cli --version

If below 1.0.66, stop and tell the user:

画板缩略图需要 lark-cli ≥ 1.0.66，当前版本是 X.X.X，请先升级：

npm install -g @larksuite/cli@1.0.66 && npx skills add larksuite/cli -y -g

升级完成后请重启 Claude Code，然后重新执行导出。

1. Fetch the document

lark-cli docs +fetch \
  --api-version v2 \
  --doc "" \
  --doc-format markdown \
  --format json > /tmp/lark_fetch.json

2. Convert, download assets, and save

The conversion script is bundled with this skill. Run it with:

python3 "$(dirname "$0")/scripts/to_markdown.py" /tmp/lark_fetch.json

Or use the full skill path (replace `` with your skills directory, typically ~/.claude/skills):

python3 /lark-to-anything/scripts/to_markdown.py /tmp/lark_fetch.json

The script:

• Creates //index.md
• Downloads all images into /assets/ concurrently (stdlib only, no pip)
• Downloads whiteboard thumbnails via lark-cli docs +media-download --type whiteboard
• Rewrites all image links to relative local paths
• Fails gracefully: failed images keep original URL, failed whiteboards keep placeholder

Pass --output-dir to save somewhere other than cwd.

3. Report back

Tell the user the path to index.md and the asset counts.

Output structure

/
  index.md          ← converted document with local image references
  assets/
    image-1.png
    whiteboard-1.png
    ...

Element conversion table

Error handling

• Permission denied: use --as user; document must be accessible to the logged-in user.
• Image download fails: Feishu image URLs expire. Re-run the fetch to get fresh URLs.
• Whiteboard fails: upgrade lark-cli to ≥ 1.0.66 (see Step 0).
• Large documents: pass --scope section or --scope keyword — see ../lark-doc/references/lark-doc-fetch.md.