一直使用语雀文档进行平时多终端同步,早期使用有道云笔记比较多,后面语雀推广的时候就入手了,虽然早期平台出现过丢数据的情况,只是作为临时使用,当在线的 typora 使用还是挺方便的。但是有时候有需求要下载很多文档到本地进行交付,那么作为懒人党必须上“手段”。

如果你还有使用过语雀文档,可以点击我的邀请链接免费领取 30 天会员:

lcry邀请你加入语雀,注册后在会员信息页填写邀请码 ZA8XGB 即可领取 30 天语雀会员。前往注册:https://www.yuque.com/about

注册之后点击个人中心,会员,会员信息,输入我的邀请码,领取会员(仅注册 7 天内的用户可以输入)

安装语雀下载工具

基于开源项目:yuque-dl

先保证有 Node.js 18.4 or later 环境:

然后执行:npm i -g yuque-dl

使用

查看帮助文档命令:

yuque-dl --help

下载公开链接所有文档链接:

# url 为对应需要的知识库地址
yuque-dl "https://www.yuque.com/yuque/ng1qth/about"

下载知识库中指定文档:

# 下载单个文档
yuque-dl doc "https://www.yuque.com/yuque/thyzgp/repository"

# 下载多个文档
yuque-dl doc "https://www.yuque.com/yuque/thyzgp/repository" "https://www.yuque.com/yuque/thyzgp/gbdfpb"

下载私有知识库:

yuque-dl "https://www.yuque.com/yuque/thyzgp" -t "你的 token..."

token如何获取?

  1. 登录语雀,浏览器右击菜单"检查"或点击快捷键 F12(Mac是Option+Command+J)
  2. 退出控制台后点击 Application
  3. 点击左侧Cookies 下的 https://www.yuque.com
  4. 右侧列表中找到 Name_yuque_session 双击Value列复制 Value的值(也就是下面图片中绿色部分)

下载公开密码访问的知识库:

  • 已经登录语雀,访问需要密码的知识库 输入密码后使用_yuque_session这个cookie

    yuque-dl "url" -t "_yuque_session的值"
  • 未登录语雀,访问需要密码的知识库 输入密码后需要使用verified_books/verified_docs这个cookie

    yuque-dl "url" -k "verified_books" -t "verified_books的值"

内置预览

使用vitepress快速启动一个web服务提供可预览下载的内容

yuque-dl server 你的知识库下载目标目录

➜  Local:   http://localhost:5173/
➜  Network: use --host to expose

最后访问:http://localhost:5173/

文章目录