Feishu2md Save
一键命令下载飞书文档为 Markdown
Feishu2Md
这是一个下载飞书文档为 Markdown 文件的工具，使用 Go 语言实现。
请看这里：招募有需求和有兴趣的开发者，共同探讨开发维护，有兴趣请联系。
动机
《一日一技 | 我开发的这款小工具，轻松助你将飞书文档转为 Markdown》
获取 API Token
配置文件需要填写 APP ID 和 APP SECRET 信息，请参考 飞书官方文档 获取。推荐设置为
- 进入飞书开发者后台
- 创建企业自建应用，信息随意填写
- 选择测试企业和人员，创建测试企业，绑定应用，切换至测试版本
- （重要）打开权限管理，云文档，开通所有只读权限
- 「查看、评论和导出文档」权限
docs:doc:readonly - 「查看 DocX 文档」权限
docx:document:readonly - 「查看、评论和下载云空间中所有文件」权限
drive:drive:readonly - 「查看和下载云空间中的文件」权限
drive:file:readonly
- 「查看、评论和导出文档」权限
- 打开凭证与基础信息，获取 App ID 和 App Secret
如何使用
注意：飞书旧版文档的下载工具已决定不再维护，但分支 v1_support 仍可使用，对应的归档为 v1.4.0，请知悉。
命令行版本
借助 Go 语言跨平台的特性，已编译好了主要平台的可执行文件，可以在 Release 中下载，并将相应平台的 feishu2md 可执行文件放置在 PATH 路径中即可。
查阅帮助文档
$ feishu2md -h
NAME:
feishu2md - Download feishu/larksuite document to markdown file
USAGE:
feishu2md [global options] command [command options] [arguments...]
VERSION:
v2-0e25fa5
COMMANDS:
config Read config file or set field(s) if provided
download, dl Download feishu/larksuite document to markdown file
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
$ feishu2md config -h
NAME:
feishu2md config - Read config file or set field(s) if provided
USAGE:
feishu2md config [command options] [arguments...]
OPTIONS:
--appId value Set app id for the OPEN API
--appSecret value Set app secret for the OPEN API
--help, -h show help (default: false)
生成配置文件
通过 feishu2md config --appId <your_id> --appSecret <your_secret> 命令即可生成该工具的配置文件。
通过 feishu2md config 命令可以查看配置文件路径以及是否成功配置。
更多的配置选项请手动打开配置文件更改。
下载为 Markdown
通过 feishu2md dl <your feishu docx url> 直接下载，文档链接可以通过 分享 > 开启链接分享 > 复制链接 获得。
示例：
$ feishu2md dl "https://domain.feishu.cn/docx/docxtoken"
Docker版本
Docker 镜像：https://hub.docker.com/r/wwwsine/feishu2md
Docker 命令：docker run -it --rm -p 8080:8080 -e FEISHU_APP_ID=<your id> -e FEISHU_APP_SECRET=<your secret> -e GIN_MODE=release wwwsine/feishu2md
Docker Compose:
# docker-compose.yml
version: '3'
services:
feishu2md:
image: wwwsine/feishu2md
environment:
FEISHU_APP_ID: <your id>
FEISHU_APP_SECRET: <your secret>
GIN_MODE: release
ports:
- "8080:8080"
启动服务 docker compose up -d
然后访问 https://127.0.0.1:8080 粘贴文档链接即可，文档链接可以通过 分享 > 开启链接分享 > 复制链接 获得。
在线版本
我使用个人的测试 API Token 部署了一个 Unstable 版本在 Render 平台上，该版本不会保存任何的文档资料和图片在容器中，直接通过 HTTP 从内存中返回压缩包文件，但是 Render 平台的 Log 可能会记录一些 HTTP 信息。
在版本仅供不在意隐私或懒于配置的用户临时使用，也可用于测试对比是否自己的 Token 权限配置有问题。Render 平台使用免费配额，仅有 512M 内存，不保证高可用性，信任链全靠开源代码，请自行斟酌。
访问 https://feishu2md.onrender.com/ 粘贴文档链接即可，文档链接可以通过 分享 > 开启链接分享 > 复制链接 获得。
感谢
Open Source Agenda Badge
