轻松导出语雀文档：yuque-exporter完整使用指南

yuque-exporter是一款高效的开源工具，能够帮助用户将语雀文档批量导出为本地Markdown文件，让您的知识库不再受平台限制，实现轻松迁移与自主管理。

🌟 工具简介：为什么选择yuque-exporter？

在信息爆炸的时代，知识管理变得尤为重要。语雀作为一款优秀的在线文档协作平台，深受用户喜爱。然而，当您需要将文档迁移到本地或其他平台时，手动下载无疑是一件繁琐的事情。yuque-exporter应运而生，它就像一位贴心的助手，为您提供了便捷、高效的文档导出解决方案。

这款工具具有诸多优势，它能够智能处理文档内容，自动下载并替换图片链接为本地路径，转换文档内部链接为相对链接，还能清理多余的HTML标签，支持frontmatter元数据，让导出的Markdown文件更加规范、易读。同时，它会根据语雀的目录结构（TOC）在本地构建相同的文件夹层次，确保文档组织关系完整保留。

📋 环境准备：让工具顺利运行

检查Node.js环境

yuque-exporter基于Node.js开发，所以首先要确保您的系统中已经安装了Node.js。打开终端，输入以下命令来检查Node.js和npm（Node.js包管理器）的版本：

node -v
npm -v

如果终端没有显示版本号，说明您还没有安装Node.js。这时，您可以前往Node.js官方网站下载并安装最新版本。

安装Git工具

为了获取yuque-exporter的项目源码，您需要安装Git版本控制工具。在终端中输入以下命令检查是否已安装Git：

git --version

如果没有安装，您可以通过相应的软件管理工具进行安装，例如在Ubuntu系统中可以使用sudo apt-get install git命令。

🚀 快速上手：三步安装与使用

第一步：克隆项目仓库

在终端中执行以下命令，将yuque-exporter的项目源码下载到本地：

git clone https://gitcode.com/gh_mirrors/yuqu/yuque-exporter

第二步：进入项目目录

克隆完成后，使用cd命令切换到项目文件夹：

cd yuque-exporter

第三步：安装项目依赖并开始导出

执行npm install命令安装项目所需的依赖包，安装完成后，通过以下命令开始导出文档（将<您的令牌>替换为您从语雀获取的实际API令牌）：

YUQUE_TOKEN=<您的令牌> npm start

✨ 核心功能：让导出更智能

智能文档处理

• 图片本地化：自动下载文档中的图片，并将链接替换为本地路径，方便离线查看。
• 链接转换：将文档内部的链接转换为相对链接，确保在本地打开时链接正常跳转。
• 标签清理：清理文档中多余的HTML标签，使Markdown文件更加简洁。
• 元数据支持：支持frontmatter元数据，为文档添加更多信息。

目录结构保持

工具会按照语雀的目录结构（TOC）在本地构建相同的文件夹层次，就像复制了一份语雀的目录树，让您在本地也能轻松找到所需文档。

⚙️ 高级配置：打造个性化导出体验

自定义输出路径

如果您想将导出的文件存放在自定义的位置，可以修改项目中的src/config.ts文件来实现。在该文件中，您可以找到相关的配置项，根据自己的需求进行修改。

命令行工具使用

除了通过环境变量的方式，您还可以直接使用命令行工具来导出文档，命令如下（将<您的令牌>替换为实际令牌）：

npx yuque-exporter --token=<您的令牌>

🧩 常见问题：解决您的困扰

导出过程中断

如果导出过程意外中断，您无需担心。重新执行导出命令，工具会自动跳过已导出的文件，继续未完成的任务，节省您的时间。

中文显示异常

当遇到中文显示问题时，可能是系统环境编码的原因。您可以在终端中执行以下命令，将系统环境编码设置为UTF-8：

export LANG=en_US.UTF-8

API调用限制

语雀API有调用频率限制（5000次/小时），如果您收到限制提示，建议稍后再试，或者分批次导出文档。

💡 使用场景与技巧：发挥工具最大价值

个人知识库迁移

当语雀调整付费策略后，免费用户可以使用yuque-exporter将个人文档批量导出，实现知识库的自主管理，让您的知识资产真正属于自己。

团队文档备份

对于团队而言，定期备份重要文档至关重要。yuque-exporter可以帮助团队轻松完成文档备份工作，确保知识资产的安全性。

多平台发布

将语雀文档导出为Markdown格式后，您可以方便地将其发布到GitHub、博客等其他平台，扩大文档的传播范围。

增量导出小技巧

工具支持增量导出功能。当您有新增或修改的文档时，只需重新运行导出命令，无需重新导出全部文档，大大提高了导出效率。

总之，yuque-exporter是一款功能强大、使用便捷的开源工具。无论您是普通用户还是开发者，都能通过它轻松实现语雀文档的批量导出。赶快尝试使用，让您的知识管理更加高效、自由！