如何把语雀全部文档备份成 Markdown：yuque-exporter 安装配置与使用指南

如何把语雀全部文档备份成 Markdownyuque-exporter 安装配置与使用指南【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter如果你需要把语雀账号里的上百篇文档搬出来或迁移到 Obsidian 等本地笔记工具yuque-exporter 可以帮你它自动模拟浏览器操作把知识库文档逐篇导出为 Markdown保留原有目录结构还能顺带把文档里的图片批量下载到本地。下面按“准备 → 安装 → 配置 → 运行 → 排障”的顺序带你走一遍。它能帮你做什么整库导出账号下的知识库逐篇导出为.md文件目录还原本地文件夹结构与语雀知识库目录一致失败重试单篇下载失败会自动重试图片处理批量下载文档内图片并可改写 Markdown 中的图片链接普通账号可用走页面模拟而非付费 API无需超级用户计划开始前先确认这些前置条件操作系统Windows、macOS、Linux 均可浏览器已安装任意 Chromium 内核浏览器Chrome、Edge、Brave 等这是自动化的“手脚”Node.js 运行环境npm install会用到装 Node 时自带Python仅当你要处理图片时才需要账号权限使用手机号 密码方式登录的个人账号团队知识库官方未做测试 获取项目并安装依赖一共两步在项目所在目录操作git clone https://gitcode.com/gh_mirrors/yu/yuque-exportercd yuque-exporter npm install依赖下载慢时可先为 npm 配置一个国内镜像源再重新执行npm install。关键配置环境变量一览表所有配置都通过环境变量传入不需要改代码。主导出和图片处理两组变量如下主导出node main.js变量是否必需默认值作用备注USER需要已有cookies.json时可不设无登录语雀的手机号首次登录必填PASSWORD需要已有cookies.json时可不设无登录密码含特殊字符时建议用单引号包裹EXPORT_PATH否当前目录下output/导出结果存放位置目录会自动创建图片处理python export-image.py变量是否必需默认值作用备注MARKDOWN_DIR否output/Markdown 文件所在目录需与导出目录一致DOWNLOAD_IMAGE否true是否把图片下载到images/子目录按年份建子文件夹UPDATE_MDIMG_URL否false是否改写 md 文件里的图片链接默认只下载不改链接REPLACE_IMAGE_HOST否空自定义图片地址前缀格式{HOST}/{年份}/{文件名}用于自建图床执行导出与结果验证Linux / macOS 下临时设置变量并启动PowerShell 用$env:USER...; $env:PASSWORD...; node .\main.jsCMD 用set命令export USER13800000000 export PASSWORD你的密码 node main.js运行后观察终端输出先出现Login successfully!随后打印知识库目录树接着逐篇显示下载进度最后输出Export successfully。打开EXPORT_PATH目录抽查带图片和长文本的几篇.md确认内容完整即可。一个省事的设计首次登录成功后登录态会写入项目根目录的cookies.json之后运行node main.js无需再传USER和PASSWORDcookie 过期后重新设置这两个变量再跑一次即可。图片与链接处理什么时候做、怎么开导出的 Markdown 里图片仍是语雀的在线链接。如果你要离线阅读、进私有仓库或迁移建议再做一步图片处理三种典型组合只备份图片直接运行python export-image.py。默认DOWNLOAD_IMAGEtrue图片会存到output/images/{年份}/md 内链接保持不变离线可用追加UPDATE_MDIMG_URLtrue图片下载的同时把链接改写成相对路径整个目录拷走也能看图自建图床DOWNLOAD_IMAGEfalseUPDATE_MDIMG_URLtrueREPLACE_IMAGE_HOST你的域名/脚本只把链接指向你的存储图片需自行上传且上传路径保持{年份}/{文件名}才能对应上PowerShell 示例$env:DOWNLOAD_IMAGEfalse; $env:UPDATE_MDIMG_URLtrue; python .\export-image.py。脚本依赖 Python 的requests库缺失时用 pip 安装一下。️ 常见卡点与排查方法报Could not find Chromium工具依赖 Puppeteer无需打开界面就能自动操作网页的无头浏览器库按默认路径找浏览器。先确认装了 Chrome 或 Edge若安装位置不同在源码中找到puppeteer.launch的调用处加上executablePath指向你本机的浏览器可执行文件个别文档反复timeout内容纯表格或纯思维导图的文档语雀官方本身就不支持直接导出 Markdown超时属于预期行为这类文档只能手动导出为其他格式登录成功但中途失败工具靠模拟页面操作工作官方 API 或登录页结构一旦变动就会失效。先到项目 Issue 区确认是否有同类反馈必要时按现有 API 自行修补验证码页面走不通自动登录只支持手机号 密码这一条路若账号触发滑块验证等需换环境或稍后重试cookies.json别外传它等价于你的登录态注意不要放进代码仓库或发到公开网盘导出路径不对EXPORT_PATH指向的目录必须已存在工具不会替你创建上级目录建议先手动建好下一步建议跑完一遍后先抽查几篇长文档确认无缺漏再决定要不要做图片改写。遇到报错优先翻项目 Issue 列表确认不是已知问题后再自己排查如果打算长期使用可以把导出命令放进定时任务每次只核对output目录里新增的文件数量即可。【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考