乐于分享
好东西不私藏

万少做了个飞书文档下载到本地markdown的工具

万少做了个飞书文档下载到本地markdown的工具

lark-doc-export – 飞书文档导出工具

功能简介

lark-doc-export 是一个用于将飞书云文档导出为本地 Markdown 文件的工具。它会自动下载文档中的图片和画板(whiteboard)缩略图,并生成结构清晰的本地文件。

主要功能

  • 导出飞书云文档(docx 类型)为 Markdown 格式
  • 自动下载文档中的所有图片到 assets 目录
  • 自动下载文档中的画板(whiteboard)为缩略图
  • 自动转换飞书特定 HTML 标签为标准 Markdown
  • 文档标题自动作为一级标题添加到文件开头
  • 支持自动覆盖已存在的输出目录

使用方法

基本用法

lark-cli docs +export --doc "https://xxx.feishu.cn/docx/xxxxxxxx"

指定输出目录

lark-cli docs +export --doc "https://xxx.feishu.cn/docx/xxxxxxxx" --output ./my-docs

或者自然语言

帮我下载这个 飞书文档  xxxx

使用文档 token(不含 URL)

lark-cli docs +export --doc "xxxxxxxx" --output ./my-docs

参数说明

参数
必填
说明
--doc
飞书文档 URL 或 token
--output
输出目录,默认为当前目录 ./

输出目录结构

导出后会生成如下结构的目录:

文档标题/
├── 文档标题.md          # 文档主体内容(Markdown 格式)
└── assets/              # 资源目录
    ├── image1.png       # 普通图片
    ├── image2.png       # 普通图片
    └── whiteboard_1.png # 画板缩略图

支持的内容类型转换

飞书内容
原始标签
转换后格式
图片
<image token="..."/> ![图片](./assets/image1.png)
画板
<whiteboard token="..."/> ![画板](./assets/whiteboard_1.png)
引用块
<quote-container>...</quote-container> > 引用内容
文件链接
<file token="..." name="..."/> [文件名](./assets/token)

前置要求

  1. 安装 Node.js (v16 或更高版本)

  2. 安装 lark-cli

    npm install -g @larksuite/cli
  3. 配置并登录飞书 CLI

    # 首次使用需要配置和授权
    lark-cli config init
    lark-cli auth login