手把手教你飞书文档转 markdown

715 阅读2分钟

手把手教你飞书文档转 markdown(命令行方式)

飞书文档有很多快捷方便的编辑方式,效率也比传统的 markdown 编辑器高,但是飞书文档没有开放直接导出 markdown 的下载方式 现在借助开源工具快捷导出飞书 markdown 版本

飞书设置

命令行版需要借助 飞书 平台的 api,所以让我们先创建一个飞书应用,用以获取 api

获取 API Token

点击链接 进入飞书开放平台 (需要使用个人账户)

RMldbcrYBoeEh9xviz7cHL9cnQb.png

创建企业 自建应用 ,信息随意填写

点击创建企业 自建应用

QpIXbeWO7or4WIxFXuYc5vhBnrf.png

按照提示填写对应的信息

EkEJbYuAJooRzwxR2A0c0Kdhn2g.png

点击左侧权限管理小项,点击开通权限,找到云文档,开通所有只读权限

「查看、评论和导出文档」权限 docs:doc:readonly

「查看 DocX 文档」权限 docx:document:readonly

「查看、评论和下载云空间中所有文件」权限 drive:drive:readonly

「查看和下载云空间中的文件」权限 drive:file:readonly

「查看和下载云空间中的文件」权限 drive:file:readonly

V0oDb6indoVXegxbgIHc31CMnBe.png

JQxHbKHUKoIhAcxNrjzcHRGinDf.png

设置好权限后创建版本,上线

T7RAbKzBzoVKI2xQcIzceSLhneh.png

WWZwb3f0UohlQzxwV9Pcf56Xnuc.png

发布成功之后,就可以获取 API ID 和密钥了

UrPVbrBtso8PluxB4eMcycG6nyd.png

飞书的设置工作到此结束了!

工具设置

通过 feishu2md 工具下载对应平台的可执行程序,下面以 mac 为例

Tttqb3lRYonk9Pxsx5PcacPYns4.png

解压后得到一个可执行的脚本文件

MyZFbtcxuojh0wxrqr8cSEAWnaf.png

把这个文件移动到 /usr/local/bin 目录下

验证

在终端任意路径输入 feishu2md --help,若能运行则成功。

实践

通过 feishu2md dl <your feishu docx url> 直接下载,文档链接可以通过 分享 > 开启链接分享 > 复制链接 获得。

Q3ZkbdVhQoHI9JxABuOc41JOnIc.png

把链接地址复制到终端双引号中后回车

An8Hbn1VuorSOqxBXvycqRRHnJc.png

得到 Downloaded markdown file to xx.md 输出说明转换成功,图片存在同级 static 目录中

RqFXbIDK3oCR6OxH7IUcT44snTc.png

大功告成!