一、飞书导出markdown

github地址：https://github.com/Wsine/feishu2md

这是一个下载飞书文档为 Markdown 文件的工具，使用 Go 语言实现。
请看这里：招募有需求和有兴趣的开发者，共同探讨开发维护，有兴趣请联系。

二、飞书获取秘钥

1、动机

《一日一技 | 我开发的这款小工具，轻松助你将飞书文档转为 Markdown》

2、获取 API Token

配置文件需要填写 APP ID 和 APP SECRET 信息，请参考飞书官方文档获取。

在这里插入图片描述

推荐设置为

进入飞书开发者后台
创建企业自建应用，信息随意填写
选择测试企业和人员，创建测试企业，绑定应用，切换至测试版本
（重要）打开权限管理，云文档，开通所有只读权限
- 「查看、评论和导出文档」权限 docs:doc:readonly
- 「查看 DocX 文档」权限 docx:document:readonly
- 「查看、评论和下载云空间中所有文件」权限 drive:drive:readonly
- 「查看和下载云空间中的文件」权限 drive:file:readonly
打开凭证与基础信息，获取 App ID 和 App Secret

在这里插入图片描述

3、创建新版本、审核

创建并且发布新版本
在这里插入图片描述
提交申请后，管理员会收到如下

进入【飞书管理后台】审核我们提交的发版

三、feishu2md本地版本

1、如何使用

注意：飞书旧版文档的下载工具已决定不再维护，但分支 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-1f5416e

   COMMANDS:
      config   Read config file or set field(s) if provided
      dump     Dump json response of the OPEN API
      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 <your feishu docx url> 直接下载，文档链接可以通过 分享 > 开启链接分享 > 复制链接 获得。

示例：

$ feishu2md https://domain.feishu.cn/docs/docxtoken

四、feishu2md docker版本

1、docker启动

Docker 镜像：wwwsine/feishu2md

Docker 命令：

docker run -it --rm -p 8080:8080 -e FEISHU_APP_ID=cli_a44a2c6a303c100b -e FEISHU_APP_SECRET=DEJY0zcd0rPnXzEkd7hAVg2w0sWbQr5M -e GIN_MODE=release wwwsine/feishu2md

在这里插入图片描述

2、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 粘贴文档链接即可，文档链接可以通过 分享 > 开启链接分享 > 复制链接 获得。