背景:需要快速将语雀文档批量导出为 Markdown 格式,或迁移到其它笔记软件中。
工具:yuque-dl
官方地址:https://github.com/gxr404/yuque-dl
安装 Node
这个工具是基于 Node 开发的,所以需要 Node 环境,版本要求 ≥ 18.4,可到官网下载:https://nodejs.org/zh-cn,选择和自己电脑操作系统一致的进行安装即可。
安装完成后,Win + R,输入 cmd 回车,输入以下命令即可
npm config set registry https://registry.npmmirror.com如果电脑上需要保留多个版本的 Node,可以使用 NVM 或 Volta 对 Node 进行版本管理切换。
安装 yuque-dl
到官网将该项目克隆到本地,或直接下载 ZIP 包解压,进入到项目目录,打开 cmd 命令行输入以下命令安装即可
npm i -g yuque-dl
如需卸载,在 cmd 命令行执行以下命令即可
npm uninstall -g yuque-dl
下载文档
公开文档
格式:
yuque-dl <url>例如下载语雀官方文档:https://www.yuque.com/yuque/thyzgp
可看到整个知识库都下载到本地了
私密文档
格式:
yuque-dl <url> -t="token 值"有些需要输入密码才能访问的文档时,需要添加上你自己的 token
注意:前提是要知道文档密码,进入到文档内容界面,该工具无法做到破解密码
登录语雀,打开文档链接,输入密码,进入到内容页后,以 Chorme 为例,快捷键 F12 打开控制台,
Cookies → https://www.yuque.com → Application → _yuque_session 对应的 Value 值,就是 token按照格式替换参数,执行命令即可
本地预览
知识库下载完成后,可以进行在线预览,格式:
yuque-dl server <本地知识库路径>如预览下载到本地的语雀官方文档
关于这款工具的更多功能,可到其官方项目地址查看:https://github.com/gxr404/yuque-dl