手把手教你飞书文档转 markdown(命令行方式)
飞书文档有很多快捷方便的编辑方式,效率也比传统的 markdown 编辑器高,但是飞书文档没有开放直接导出 markdown 的下载方式 现在借助开源工具快捷导出飞书 markdown 版本
飞书设置
命令行版需要借助 飞书 平台的 api,所以让我们先创建一个飞书应用,用以获取 api
获取 API Token
点击链接 进入飞书开放平台 (需要使用个人账户)
创建企业 自建应用 ,信息随意填写
点击创建企业 自建应用
按照提示填写对应的信息
点击左侧权限管理小项,点击开通权限,找到云文档,开通所有只读权限
「查看、评论和导出文档」权限 docs:doc:readonly
「查看 DocX 文档」权限 docx:document:readonly
「查看、评论和下载云空间中所有文件」权限 drive:drive:readonly
「查看和下载云空间中的文件」权限 drive:file:readonly
「查看和下载云空间中的文件」权限 drive:file:readonly
设置好权限后创建版本,上线
发布成功之后,就可以获取 API ID 和密钥了
飞书的设置工作到此结束了!
工具设置
通过 feishu2md 工具下载对应平台的可执行程序,下面以 mac 为例
解压后得到一个可执行的脚本文件
把这个文件移动到 /usr/local/bin
目录下
验证:
在终端任意路径输入 feishu2md --help
,若能运行则成功。
实践
通过 feishu2md dl <your feishu docx url> 直接下载,文档链接可以通过 分享 > 开启链接分享 > 复制链接 获得。
把链接地址复制到终端双引号中后回车
得到 Downloaded markdown file to xx.md 输出说明转换成功,图片存在同级 static 目录中
大功告成!