yuque-exporter手把手把语雀文档批量导出为 Markdown【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter语雀里的文档散落在十几个知识库想整包备份成 Markdown官方批量导出却只对付费账号开放yuque-exporter 是一款语雀导出工具用真实浏览器模拟人工操作把全部知识库文档批量导出为本地 Markdown还能把文档里的图片下载到本地。30 秒看懂语雀文档如何变成本地 Markdown语雀对普通账号只允许一篇篇导出这款 yuque 备份工具靠“装真人”绕开了限制。核心机制四句话它做什么它怎么做模拟真人登录用 Puppeteer驱动无头 Chrome 的库打开登录页输入账号密码、滑过滑块拉取知识库目录调用语雀内部接口拿到知识库列表和目录树逐篇转存文档访问每篇文档的 Markdown 导出地址下载落盘处理文档内图片单独的 Python 脚本批量下载图片并改写图片链接全程不经过任何第三方中转服务文档一直留在你本地磁盘。环境清单动手前要装什么项目要求版本获取方式备注Node.js建议 ≥ 16Node.js 官网npm 自带装依赖慢可换淘宝镜像Chromium 内核浏览器任意版本Chrome、Edge、Opera 等Puppeteer 启动需要Python≥ 3.x系统包管理器只做图片处理时需要项目代码最新版git clone见下一节验证三样都就绪node -v npm -v python -V看到三个版本号即依赖就绪Windows 上可用where python确认位置。✅ 最短路径跑通首次语雀文档导出下面是语雀文档转 Markdown 的最短路径复制整段执行替换两处占位值git clone https://gitcode.com/gh_mirrors/yu/yuque-exporter cd yuque-exporter npm install export USER13800000000 PASSWORDabcd1234 # ← 换成你的实际账号和密码 node main.js首次运行要下载 Chromium 依赖耗时一两分钟Windows 跳过export一行改用set见下文。全流程用到的环境变量统一收在这张表变量名作用是否必须默认值USER语雀登录账号手机号首次运行必须空PASSWORD语雀登录密码首次运行必须空EXPORT_PATHMarkdown 保存目录否./outputMARKDOWN_DIR图片脚本处理的 Markdown 目录否./outputDOWNLOAD_IMAGE是否把图片下载到本地否trueUPDATE_MDIMG_URL是否改写文件内图片链接否falseREPLACE_IMAGE_HOST自建图床的自定义域名否空配置登录凭据没有现成 cookie 时工具用账号密码在无头浏览器里登录成功后自动保存cookies.json。macOS / Linux 先导出两个变量再运行export USER13800000000 # ← 换成你的语雀登录账号 export PASSWORDabcd1234 # ← 换成你的语雀登录密码 node main.jsWindows cmd 用set写同名变量set USER13800000000 set PASSWORDabcd1234 node main.js终端出现Login successfully!即登录成功源码旁多出的cookies.json就是凭据凭证之后运行直接复用它不用再输密码。执行批量导出登录成功后main.js 会自动拉取知识库列表、打印目录树再逐篇下载文档。想把这份 yuque 备份放到指定位置运行前指定EXPORT_PATHEXPORT_PATH/data/yuque-backup node main.js运行后终端先输出Books count is: N和完整目录树随后每篇文档依次打出Download document ... finished最后一行是Export successfully!。验证导出结果打开保存目录确认结构和线上知识库同构ls -R output | head -30预期看到每个知识库一个一级目录里面是 .md 文件分组标题变成子目录一篇文档一个文件。下面是运行效果演示旧版界面交互与新版一致如果你还需要处理文档里的图片默认导出的 Markdown 里图片仍指向语雀图床链接失效后图片就会 404。项目自带export-image.py处理这件事相关变量在上面那张表里。想让素材完全本地化一条命令把所有图片下载到 output 下的images目录不动 Markdown 原文python export-image.py跑完 Markdown 目录旁多出images目录文件数与文档内图片引用一致。想把图片链接改写成相对路径适合迁移到本地笔记软件彻底不依赖图床DOWNLOAD_IMAGEfalse UPDATE_MDIMG_URLtrue python export-image.py效果文件内图片链接全部变为指向本地images目录的相对路径。有自己的对象存储图片指向自建域名上传路径格式为{域名}/{年}/{文件名}DOWNLOAD_IMAGEfalse UPDATE_MDIMG_URLtrue \ REPLACE_IMAGE_HOST你的图片域名/ python export-image.py # ← 换成你的图床域名跑完文件内所有图片链接都指向你的域名语雀图床彻底脱钩。⚠️ 你可能踩的坑如果第 1 步卡在USER required—— 没有 cookie 文件且没设账号。设置USER、PASSWORD后重跑。如果报Could not find Chromium—— Puppeteer 找不到浏览器安装路径。给main.js里的puppeteer.launch加上executablePath指向本机 Chrome 或 Edge 可执行文件。如果某篇文档反复Download timed out—— 多半是纯表格或思维导图文档官方本就不支持导成 Markdown。到语雀网页端手动导出它放进对应目录。如果之前能登录突然失效—— 语雀改了登录页或内部接口。先看官方仓库的最新提交和 Issue 有没有修复也可以对着最新接口自己改源码。如果python export-image.py报缺模块—— 脚本的第三方依赖没装。按提示用pip install 库名补齐。yuque-exporter 把原来一篇篇手动点击的动作变成一条命令的 yuque 备份文档和图片全部落在自己磁盘。遇到 bug 直接到官方仓库提 Issue 跟进修复。【免费下载链接】yuque-exporterA tool for exporting Yuque documents as markdown.项目地址: https://gitcode.com/gh_mirrors/yu/yuque-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
