
3 分钟把语雀文档全搬进 Markdownyuque-exporter 安装配置实录【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter语雀文档想批量搬进本地 Markdown一篇篇手动复制粘贴实在太痛苦。yuque-exporter 就是干这事的它模拟真实浏览器按知识库目录逐篇导出 Markdown还能把文档里的图片下载到本地、替换好链接一次完成语雀批量备份。从 clone 到第一次跑通先准备好 Node.js 环境能正常跑npm即可。然后把代码克隆下来装依赖git clone https://gitcode.com/gh_mirrors/yu/yuque-exporter cd yuque-exporter npm install依赖里有 Puppeteer安装体积偏大耐心等待或先切个快的镜像源。装完后第一次运行要交账号密码用环境变量带进去就行USER你的用户名 PASSWORD你的密码 node main.js首次运行会拉起一个无头浏览器自动登录语雀按知识库目录结构逐篇导出默认全部落在output/目录。登录成功后 cookie 会存成cookies.json以后直接node main.js就能接着导密码都不用再输。首次运行前必改的 3 类变量登录凭据USER/PASSWORD首次运行必填。⚠️ 一旦生成了cookies.json后续登录态就走 cookie 文件这两个变量就不再需要了。密码含特殊字符时用单引号包住避免 shell 转义坑。导出目录EXPORT_PATH默认是./output嫌麻烦就不用动想让备份落到指定位置时再显式指定比如EXPORT_PATH/path/to/backup node main.js。图片处理开关MARKDOWN_DIR/DOWNLOAD_IMAGE/UPDATE_MDIMG_URL/REPLACE_IMAGE_HOST这四个只跟图片后处理脚本export-image.py搭配使用只做文字导出的话完全不用管。图片不下载只改链接怎么办默认情况下图片脚本会把文内图片全部下到output/images/Markdown 里的远程链接保持不动。如果你只想要干净链接、不要图片文件就关掉下载、打开链接重写DOWNLOAD_IMAGEfalse UPDATE_MDIMG_URLtrue python export-image.py再进一步图片已经传到自己对象存储的话设置REPLACE_IMAGE_HOST为你的域名链接会按{域名}/年份/图片名的格式重写。MARKDOWN_DIR默认指向output/Markdown 不在这里就先改它。它为什么这么设计语雀不给普通用户开放批量导出接口yuque-exporter 干脆让 Puppeteer 打开真实浏览器、模拟用户点导出逐篇完成绕开了对 API 工具的权限限制。Node.js 负责登录和文档导出整条链路Python 脚本只管导出后的图片下载与链接重写两者各司其职图片部分也可以单独拿出来用。排坑清单遇到这些现象先查这里报Could not find Chromium本机装了 Chrome/Edge 但路径不在 Puppeteer 的默认查找位置改一下源码里浏览器启动配置用executablePath指向浏览器可执行文件的实际路径。导出突然全线失败多半是语雀内部接口或页面结构变了对照项目最新版本按实际接口修正源码里的请求逻辑。团队知识库导不出来团队导出没有官方保障也未充分测试先确认团队管理端的权限再决定要不要折腾。某篇文档 timeout 报错纯表格或思维导图文档官方本身不支持直接导出为 Markdown这类文档手动换成其他格式。跑通了就把链接甩给同事备份握在自己手里迁移的事就稳了。【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考