简单快速完成语雀文档导出：完整指南

语雀文档导出工具yuque-exporter是一款专为语雀用户量身定制的开源解决方案，帮助用户轻松将语雀平台上的文档批量导出为本地Markdown格式。随着语雀从内容社区转型为创作工具并调整付费策略，这款工具为需要迁移个人博客内容的免费用户提供了极大的便利。

🚀 准备工作：获取语雀API访问权限

要开始使用语雀文档导出功能，首先需要获取API Token。登录语雀官方网站后，进入个人设置中的"开发者管理"部分，点击生成新的访问令牌。请务必将这个Token妥善保存，它将是后续导出操作的关键凭证。

📝 快速上手：三步完成文档导出

第一步：安装工具 使用简单的npm命令即可快速安装yuque-exporter工具：

npx yuque-exporter --token=你的令牌

第二步：配置环境 确保系统中已安装Node.js环境，这是运行该工具的基础要求。项目采用TypeScript开发，具有更好的类型安全性和代码维护性。

第三步：执行导出 运行命令后，工具会自动调用语雀API接口，获取所有文档元数据，并根据目录结构在本地构建相应的文件夹层级。

🔧 核心功能详解

智能目录构建

yuque-exporter会根据语雀的TOC（目录）信息自动创建本地目录结构。当前版本默认使用中文目录和文件名，确保与原始文档结构保持一致。

内容处理机制

工具会对文档内容进行多方面的智能处理：

• 自动下载图片和画板内容到本地
• 替换文档间的链接为相对路径
• 清理多余的HTML标签
• 支持frontmatter格式

草稿文件管理

草稿文档会直接保存在根目录下，这样的设计便于管理文档间的相对链接，确保导出后的文档结构清晰可用。

💡 使用技巧与优化建议

文件名处理技巧 如果遇到文件系统不支持中文文件名的情况，可以关注项目的后续更新，未来版本可能会提供配置选项，允许用户选择使用Slug（英文和数字组合）或保持中文名称。

批量导出策略 由于语雀API存在调用频率限制（目前为5000次/小时），建议在文档数量较多时分批次进行导出操作。

📁 项目架构概览

yuque-exporter项目的代码结构清晰，主要模块包括：

• 核心配置模块：src/config.ts
• API调用模块：src/lib/sdk.ts
• 文档处理模块：src/lib/doc.ts
• 目录构建模块：src/lib/tree.ts

每个模块都有明确的职责分工，确保了工具的高效运行和良好的可扩展性。

🎯 适用场景分析

这款语雀文档导出工具特别适合以下场景使用：

• 个人博客从语雀迁移到其他平台
• 团队文档的本地备份需求
• 内容创作的多平台分发
• 文档的长期归档保存

通过本指南的详细介绍，相信您已经对如何使用yuque-exporter进行语雀文档导出有了全面的了解。无论是个人用户还是团队用户，都能通过这个工具轻松实现文档的迁移和备份需求。