很多用户搜索“语雀怎么导入 Obsidian”，其实真正要解决的不是 Obsidian 能不能读 Markdown，而是语雀侧如何一次性导出完整知识库、图片和目录结构。手动复制粘贴只能搬走正文，图片、代码块、表格、附件和层级关系很容易丢。
本文给出一条可复用的实操路线：先用 YuqueOut 批量导出语雀知识库，再把导出的 Markdown 文件夹交给 Obsidian 读取。你可以把它作为一次性迁移，也可以把它变成每周备份到本地 Vault 的长期流程。
- 迁移到 Obsidian 推荐使用 Markdown + 图片本地化，这是兼容性最高的组合。
- 导出后的文件夹可以直接作为 Obsidian Vault 打开，目录结构会在文件浏览器中呈现。
- 双链不会自动生成，导入解决的是内容搬家，双链整理需要后续用 Wikilink、反向链接和图谱逐步完成。
- 迁移后优先检查文件数量、图片路径和核心文档链接，再做大规模重命名或整理。
语雀可以迁移到 Obsidian 吗？
可以，但不是“一键直连导入”。 推荐流程是先把语雀知识库导出为标准 Markdown 文件，再让 Obsidian 读取这些本地文件。根据 Obsidian 官方数据存储说明，Vault 本质上是一个本地文件夹，笔记以 Markdown 纯文本文件形式保存。
这意味着迁移的关键条件只有三个：文档能变成 .md 文件，图片能保存在本地，目录结构能保留下来。YuqueOut 的作用就是把这三步合并：从语雀批量读取内容，在浏览器本地转换为 Markdown，并把语雀 CDN 图片下载到本地目录。
如果你的知识库包含表格、画板、加密文档或收藏文档，也建议先看 语雀数据迁移完全指南，确认每类内容的迁移边界。普通语雀文档迁移到 Obsidian 的主线，仍然应该围绕 Markdown 进行。
为什么迁移 Obsidian 推荐用 Markdown？
Obsidian 原生围绕 Markdown 文件工作。根据 Obsidian 支持文件格式说明，Markdown 是最核心的笔记格式，常见图片、PDF 等文件可以作为附件一同放在 Vault 中。
| 格式 | 适合迁移 Obsidian 吗 | 原因 |
|---|---|---|
| Markdown | 推荐 | 可直接被 Obsidian 读取，支持全文搜索、编辑、内部链接和版本管理。 |
| Word | 不作为首选 | 适合二次排版，但进入 Obsidian 前仍要转换为 Markdown。 |
| 适合归档 | 适合只读保存，不适合双链、图谱和长期编辑。 | |
| JPG/长图 | 不适合主迁移 | 只能保留视觉结果，搜索和编辑能力几乎丢失。 |
Markdown 的另一个优势是可迁移性。迁出语雀后，你不仅能在 Obsidian 中使用，还可以用 Git 管理、用 VS Code 编辑，或者继续迁移到 Hugo、VitePress 等静态站点。更完整的格式说明可以参考 语雀转 Markdown 完整指南。
迁移前要准备什么？
迁移前不需要申请语雀 API Token，也不需要写脚本。建议准备以下环境：
- Chrome 或 Edge 浏览器：用于安装和运行 YuqueOut。
- YuqueOut 扩展：用于批量导出语雀知识库。
- Obsidian 桌面端：用于打开本地 Vault 并检查导入结果。
- 足够的本地磁盘空间：图片多的知识库通常比纯文本大很多。
- 一个测试知识库或小目录：大规模迁移前，先用 5-10 篇文档验证格式。
不要第一次就导出上千篇文档再直接移动到长期 Vault。先选一个包含标题、图片、表格、代码块和附件的小目录做测试，确认 Obsidian 中显示正常后再全量迁移。
第一步：用 YuqueOut 批量导出语雀知识库
打开语雀并保持登录状态，点击浏览器工具栏里的 YuqueOut 图标。扩展会读取你能访问的个人知识库、团队知识库和协作文档列表。具体安装和基础操作可参考 语雀知识库批量导出完整教程。
- 选择要迁移的知识库。 如果文档量很大，建议按项目或目录分批导出，便于后续检查。
- 导出格式选择 Markdown。 这是 Obsidian 最自然的导入格式。
- 开启 Markdown 图片本地化。 语雀 CDN 图片直接放到 Obsidian 里可能裂图，必须优先本地化。
- 保留目录结构。 导出后文件夹层级会成为 Obsidian 文件浏览器中的层级。
- 导出完成后查看失败列表。 如果有少量失败文档，先单独重试，不要急着进入 Obsidian。
如果你遇到导出权限限制，可以阅读 语雀所见即所得导出详解。YuqueOut 的本地转换路径不依赖语雀官方导出 API，只要浏览器能打开的内容，就可以尝试转成 Markdown。
第二步：检查 Markdown、图片和目录结构
导出完成后，不要立刻开始双链整理。先做一次文件级检查，确保迁移基础是完整的。
检查文件数量
把语雀知识库中的文档数量和本地导出的 .md 文件数量做一次粗略对比。如果数量差异明显，先回到导出日志看是否有失败任务、加密文档或无权限文档。
检查图片目录
开启图片本地化后，文档中的图片会保存到本地 assets/ 目录，并在 Markdown 中变成相对路径。随机打开几篇图片多的文档，确认本地 Markdown 预览能正常显示图片。图片问题的根因和处理方式可参考 语雀图片防盗链解决方案。
检查特殊内容
语雀画板、思维导图、复杂表格和嵌入卡片不一定能完整变成标准 Markdown。画板类内容更适合导出为 PNG 或 SVG 后作为附件放入 Vault；语雀表格可以按需要导出为 Excel、CSV 或 Markdown 表格。混合知识库建议同时阅读 语雀表格、画板、数据表导出攻略。
第三步：在 Obsidian 中打开导出的 Vault
根据 Obsidian 管理 Vault 的官方说明，Vault 是一个包含笔记、附件和配置的文件夹。迁移时有两种常见做法。
方式一：直接将导出文件夹作为新 Vault
- 打开 Obsidian。
- 选择打开已有文件夹作为 Vault。
- 选择 YuqueOut 导出的知识库文件夹。
- 等待 Obsidian 建立索引。
- 在文件浏览器中检查目录层级和 Markdown 文件。
这种方式最适合个人知识库迁移。优点是干净，不会污染原来的 Obsidian Vault；缺点是如果你已经有长期维护的 Vault，需要后续再合并。
Obsidian 会在 Vault 根目录创建 .obsidian/ 配置目录，用来保存插件、主题和工作区设置。不要在已有 Vault 里面再创建嵌套 Vault，否则后续同步、搜索和链接维护都更容易混乱。
方式二：复制到已有 Vault
如果你已有一个成熟的 Obsidian Vault，可以把导出的知识库文件夹复制到 Vault 中的某个目录，例如 Yuque/项目文档/。复制后打开 Obsidian，等待索引完成，再检查图片是否显示。
这种方式适合长期知识库整合，但建议先保留原始导出备份。后续重命名、移动文件或改链接时，如果出错，还可以从原始导出重新恢复。
第四步：把语雀目录整理成 Obsidian 双链知识库
导入 Markdown 不等于自动拥有高质量双链。导出解决的是“内容搬家”，双链整理解决的是“知识关系”。Obsidian 支持 内部链接、反向链接 和 图谱视图，但这些能力需要你在迁移后主动组织。
把语雀目录页改造成 MOC
如果语雀知识库里原本有“目录”“导航”“项目索引”这类页面，可以把它们改造成 Obsidian 中的 MOC（Map of Content）。例如把原来的项目目录整理成：
## 项目文档
- [[需求池]]
- [[接口说明]]
- [[上线流程]]
- [[故障复盘]]
这样做比一开始就给所有文件建立链接更现实。先抓住核心主题，再逐步扩散到细节文档。
用未链接提及补全关系
迁移后先挑出高频概念，例如产品名、客户名、技术模块、项目代号。创建对应主题页后，在反向链接面板中查看未链接提及，把真正相关的提及改成 [[主题名]]。这比全局批量替换更准确。
用图谱视图检查孤立文档
打开图谱视图后，孤立节点通常意味着文档没有和其他内容建立关系。不要追求图谱“好看”，只需要用它发现关键文档是否被孤立、重要主题是否形成连接即可。
迁移后常见问题与避坑
图片打不开怎么办？
先检查 Markdown 中图片地址是否仍然是 https://cdn.nlark.com。如果是，说明没有完成图片本地化，应重新导出或单独处理图片。正确状态通常是 assets/文档名-1.png 这类相对路径。
语雀内部链接还是 yuque.com 链接怎么办？
这是正常现象。语雀内部链接在导出后可能仍是网页链接。建议先保留，等核心文档导入稳定后，再逐步把高频内部链接改成 Obsidian 的 [[文档名]]。不要在迁移第一天就试图全量替换所有链接。
团队知识库要拆成几个 Vault？
如果团队文档边界清晰，例如研发、产品、运营互相独立，可以按团队拆分 Vault。如果文档之间引用很多，建议放在一个 Vault 中按顶层文件夹区分。团队迁移策略可以参考 团队知识库迁移方案。
要不要把所有链接都改成 Wikilink？
不需要。Obsidian 同时支持 Wikilink 和 Markdown 链接。迁移初期先保证内容可读、图片可见、搜索可用，再逐步把核心概念改成 Wikilink。链接整理是知识库维护工作，不应该阻塞迁移本身。
迁移效果检查清单
- 语雀知识库中的核心文档是否都有对应
.md文件。 - 图片是否已经进入本地
assets/目录。 - Obsidian 文件浏览器是否能显示原始目录层级。
- 搜索几个关键词，确认正文能被 Obsidian 检索到。
- 抽查代码块、表格、引用、任务列表是否可读。
- 创建 3-5 个核心主题页，开始建立第一批内部链接。
- 保留一份原始导出目录，不要只保留整理后的 Vault。
常见问题
语雀可以直接导入 Obsidian 吗？
不能直接一键导入。推荐先用 YuqueOut 将语雀知识库批量导出为 Markdown，并开启图片本地化，然后在 Obsidian 中把导出的文件夹作为 Vault 打开。
语雀迁移到 Obsidian 用什么格式最好？
推荐 Markdown。Obsidian 原生使用 Markdown 文件作为笔记格式，导入后可以直接搜索、编辑、建立内部链接和查看反向链接。
迁移到 Obsidian 后图片会丢失吗？
如果只保留语雀 CDN 外链，图片可能无法正常显示。导出时开启 YuqueOut 的图片本地化功能，图片会保存到本地 assets/ 目录，并在 Markdown 中使用相对路径引用。
语雀的目录结构能保留到 Obsidian 吗？
可以。YuqueOut 会按语雀知识库原始目录保存 Markdown 文件，Obsidian 打开该文件夹后，会在文件浏览器中显示对应的文件夹层级。
导入 Obsidian 后会自动变成双链知识库吗？
不会完全自动。Obsidian 支持内部链接、反向链接和图谱视图，但高质量双链需要迁移后继续整理，例如创建索引页、补充 [[文档名]] 链接、处理未链接提及。