语雀文档导出终极指南：5分钟完成批量Markdown迁移

还在为语雀文档迁移而烦恼吗？😮‍💨 语雀文档导出工具让你轻松实现批量文档迁移，将语雀文档快速转换为本地Markdown文件！无论是个人博客迁移、团队文档备份，还是平台转换，这个强大的工具都能在5分钟内帮你搞定。

语雀文档导出工具是一个专门为语雀用户设计的开源项目，能够快速批量导出语雀文档为本地Markdown格式。支持图片下载、链接转换、Frontmatter生成等实用功能，让你的文档迁移过程变得简单高效。

🚀 为什么需要语雀文档导出工具？

随着语雀定位从"内容社区"转变为"创作工具"，以及新的付费策略实施，许多免费用户无法继续使用语雀作为个人博客平台。这时候，一个可靠的文档导出工具就显得尤为重要！

主要痛点：

• 语雀免费用户功能受限
• 个人博客需要迁移到其他平台
• 团队文档需要备份到本地
• 文档格式转换困难

💡 核心功能亮点

一键批量导出

工具支持一次性导出整个知识库的所有文档，无需手动逐篇处理。只需配置好语雀Token，就能自动抓取并转换所有文档。

智能格式处理

• 自动下载图片：将语雀文档中的在线图片下载到本地
• 链接转换：将语雀内部链接转换为相对路径
• Frontmatter生成：为每篇文档自动添加标题、原始链接等元数据
• HTML标签清理：自动处理多余的HTML标签，如<br/>

保持目录结构

工具会根据语雀的目录结构（TOC）在本地重建相同的文件夹层次，确保文档组织结构不变。

📋 快速开始指南

准备工作

首先需要申请语雀Token，参考官方文档获取你的专属Token。

安装与使用

$ npx yuque-exporter --token=<你的token>

就是这么简单！工具会自动开始抓取你的语雀文档，并将其转换为标准的Markdown格式保存在本地。

🔧 技术实现原理

语雀文档导出工具采用了模块化架构设计，主要包含以下几个核心模块：

数据抓取模块 (src/lib/crawler.ts)

通过语雀官方API获取文档数据，包括知识库信息、目录结构和文档内容。

文档构建模块 (src/lib/builder.ts)

负责将抓取的数据转换为本地文件结构，处理目录树和文档生成。

内容处理模块 (src/lib/doc.ts)

使用remark生态系统进行文档内容处理，包括：

• 图片资源下载
• 链接相对化
• Frontmatter添加
• HTML标签清理

🎯 实际使用效果

使用语雀文档导出工具后，你将获得：

• 完整的本地Markdown文档库
• 保持原有的目录结构
• 自动下载的图片资源
• 可读性强的相对链接

💪 进阶使用技巧

指定知识库导出

如果你只想导出特定的知识库，可以使用URL路径参数：

$ npx yuque-exporter --token=<token> atian25/test

开发模式运行

如果你想深入了解工具的工作原理或进行二次开发：

$ git clone https://gitcode.com/gh_mirrors/yuqu/yuque-exporter
$ cd yuque-exporter
$ npm i
$ YUQUE_TOKEN=<你的token> npm start

🛠️ 项目架构解析

语雀文档导出工具采用TypeScript开发，确保代码质量和类型安全。项目结构清晰：

• 核心逻辑：位于src/lib/目录
• 配置文件：src/config.ts
• 入口文件：src/main.ts

🎉 总结

语雀文档导出工具是每个语雀用户的必备神器！无论是个人文档迁移还是团队知识库备份，都能在几分钟内完成。告别繁琐的手动操作，享受自动化带来的便利。

立即尝试，开启你的文档迁移之旅！✨