语雀文档迁移有四种方法：一、导出Markdown，兼容性强但丢失评论与附件元数据；二、调用开放API批量拉取，适合定制化大规模迁移；三、复制粘贴+格式清理，适用于少量文档；四、使用第三方同步工具如FlowUs Sync，支持实时镜像但平台受限。

如果您需要将语雀中的文档迁移到其他平台，可能是因为团队协作需求变化或平台功能调整。以下是几种可行的迁移方法：

一、导出为 Markdown 文件

语雀原生支持将单篇文档或知识库批量导出为 Markdown 格式，该格式兼容性强，可直接导入多数笔记平台（如 Notion、Obsidian、Typora 等）。导出过程保留标题层级、列表、代码块及内联链接，但不包含评论、附件元数据和协同编辑历史。

1、登录语雀网页端，进入目标文档或知识库首页。

2、点击右上角「更多」按钮，选择「导出」→「Markdown（.zip）」。

3、等待系统打包完成，下载生成的 ZIP 压缩包。

4、解压后检查 .md 文件是否包含预期内容，特别核对图片路径是否为相对引用或已内嵌 Base64。

5、在目标平台中使用「导入 Markdown」功能上传对应文件，部分平台需手动上传图片至图床并替换链接。

二、使用语雀开放 API 批量拉取内容

通过调用语雀官方提供的 RESTful API，可程序化获取文档结构、正文、附件 URL 及元信息，适用于需定制化处理（如字段映射、格式清洗、自动重命名）的大规模迁移场景。该方式要求具备基础编程能力，并需提前申请语雀开发者 Token。

1、前往语雀开放平台控制台，创建应用并获取 Client ID 与 Client Secret。

2、使用 OAuth2 流程获取用户授权后的 Access Token。

3、调用 GET /v2/repos/{repoId}/docs 接口列出知识库全部文档 ID 与路径。

4、对每个文档 ID 调用 GET /v2/repos/{repoId}/docs/{docId} 获取 HTML 渲染内容与原始语雀语法。

5、解析返回 JSON 中的 content 字段，按目标平台要求转换为适配格式（如 Notion 的 Block 结构或 Confluence 的 Wiki Markup）。

三、复制粘贴结合格式清理工具

适用于少量关键文档的快速迁移，尤其当目标平台不支持标准导入时（如企业自建 Wiki 或飞书文档早期版本）。该方法依赖人工操作，但可控性高，能即时校验排版效果，需配合外部工具处理富文本残留样式。

1、在语雀中打开待迁移文档，按 Ctrl+A 全选内容，再按 Ctrl+C 复制。

2、粘贴至 VS Code 或 Sublime Text 等纯文本编辑器，清除隐藏 HTML 标签与不可见字符。

3、使用正则表达式替换工具（如 VS Code 的查找替换）批量处理：将 <span style="color: #ff6b6b"> 替换为空，将 <br> 替换为 \n。

4、将清理后的文本复制进目标平台编辑区，逐段检查加粗、引用、表格等元素是否正确渲染。

5、手动重新上传语雀中引用的本地图片，并更新文中 img 标签 src 属性为新地址。

四、借助第三方同步工具（如 FlowUs Sync）

部分第三方工具提供语雀到特定平台的单向同步能力，例如 FlowUs Sync 支持将语雀知识库实时镜像至 FlowUs 页面，过程中自动转换标题锚点、维护文档树结构，并同步更新修订时间戳。该方案无需编码，但仅限支持的平台列表，且可能受限于工具订阅权限。

1、在 FlowUs 官网注册账号并开通 Sync 功能权限。

2、进入 Sync 设置页，选择「语雀」作为源平台，点击「连接账户」并完成 OAuth 授权。

3、从语雀侧选择需同步的知识库，设定目标 FlowUs 工作区与父页面。

4、启用「自动同步」开关，工具将在后台拉取全量文档并建立映射关系。

5、在 FlowUs 中检查首屏加载速度、目录导航层级及内部跳转链接是否正常生效。