如何把 Obsidian 库导入 Flexnote：笔记、双链与 Canvas 迁移指南（2026）

真正让人迟迟不换笔记工具的，通常不是新工具学不会，而是旧库搬不动。 一个用了几年的 Obsidian Vault 里，除了 Markdown 文件，还有目录、标签、双链、图片、PDF， 以及花了不少时间排好的 Canvas。让人把这些全部丢下，从空白页重新开始，不现实。

Flexnote 现在可以直接读取本机 Obsidian 库。你可以选择整个 Vault，也可以只迁移几个一级目录； Markdown 笔记会进入卡片库，原目录会出现在侧栏的「Ob导入」收藏树中。 如果开启 Canvas 导入，白板上的文本、笔记、分组、附件和连线也会一起转换。

哪些内容可以导入？

这次导入并不是简单地把 Markdown 正文复制一遍。Flexnote 会先扫描 Vault，再按内容类型做转换。 当前支持的主要内容如下：

导入前，先知道几个转换规则

目录会保留，但它承担的是导航作用

假设 Vault 里有「研究 / 论文 A / 文献笔记」这样的目录。导入后，侧栏会创建 「Ob导入 / 研究 / 论文 A / 文献笔记」收藏层级，并把对应卡片放进去。 卡片本身仍然存在于 Flexnote 卡片库中，收藏树负责保留你熟悉的入口。

标签会进入 Flexnote 标签体系

如果笔记的 YAML Properties 中填写了 tags，导入时优先使用这些标签；没有 Properties tags 时，再读取正文里的 #标签。已经转成标签的正文标记会被清理，避免同一个标签既挂在卡片上， 又以普通文字重复留在正文中。

双链会尽量继续指向原来的笔记

[[笔记名]]、带路径的双链和 [[笔记名|显示别名]]会在导入时匹配本批次笔记。匹配成功后，它们会变成可以直接打开对应卡片的链接。 找不到目标的链接不会被随手删掉，而会保留标题，方便之后继续查找和补全。

Obsidian 特有语法会做兼容处理

Callout 会保留为带图标的引用块；Obsidian 注释会被移除；脚注、任务列表、高亮、上下标和 details 折叠内容会转换为 Flexnote 编辑器可以识别的形式。复杂主题样式、插件生成的自定义语法， 以及除 tags 之外的 Properties 不保证一比一还原，迁移后建议抽查几篇结构最复杂的笔记。

如何导入 Obsidian Vault

第一步：打开导入入口，选择 Obsidian 库

在 Flexnote 左侧边栏打开收藏区域，然后进入导入窗口，选择「Obsidian 库」。 桌面端会尝试列出这台电脑上已经注册的 Vault，最近打开的库会排在前面。 如果目标库没有出现，也可以点击「选择其他目录」，手动定位到 Vault 根目录。

第二步：选择要迁移的目录

Flexnote 会统计 Vault 根目录和各个一级目录中的笔记、Canvas 数量。你可以全选，也可以只勾选 「正在进行的项目」「课程笔记」之类仍在使用的目录。这样很适合分批迁移：先搬高频内容， 检查排版和链接，再处理归档资料。

「导入 Canvas 画布」默认开启。如果这次只想迁移 Markdown，可以把它关掉；Canvas 文件仍会留在原 Vault 中，之后可以重新选择同一个目录再导入。

第三步：开始导入并检查「Ob导入」收藏树

导入过程中会显示当前文件和整体进度。完成后，侧栏会出现「Ob导入」文件夹；展开它， 就能看到按原目录排列的笔记与白板。导入结果还会分别统计新建笔记、更新笔记、新建画布、 更新画布、跳过项和补充的收藏入口。

Canvas 导入后会变成什么？

Obsidian Canvas 与 Flexnote 白板的结构并不完全相同，所以这里做的是类型转换，而不是把 JSON 原样塞进新白板。Flexnote 会尽量保留节点位置、尺寸、颜色、分组关系和连线方向。

• 文本节点转成白板文本，节点内 Markdown 会继续转换；
• 指向 Markdown 的文件节点会引用已经导入的笔记卡片；
• 图片、视频和音频转成媒体卡片，PDF 转成 PDF 卡片；
• 其他附件转成文件节点，网页链接转成网页卡片；
• Group 转成白板分组，并根据空间位置恢复内部节点；
• Edges 转成连线，保留标签、颜色、连接方向和箭头样式。

如果 Canvas 引用了一个找不到的文件，Flexnote 会用文本节点标出原文件名，而不是让该位置直接消失。 这能帮助你在迁移后发现缺失附件。由于两套画布的渲染模型不同，复杂嵌套分组、特殊颜色或插件扩展节点 仍可能需要手动调整。

第二次导入同一个库，会不会产生重复笔记？

默认不会。Flexnote 会记录每篇导入笔记和每张 Canvas 在 Vault 内的相对路径。 再次扫描同一路径时，会把它识别为已经导入的内容，并让你选择处理方式：

• 跳过已存在：保留 Flexnote 中已经编辑过的版本，只导入 Vault 里新增的文件。 这是默认选项，也最适合日常增量迁移。
• 覆盖已存在：用 Obsidian 当前内容更新原笔记；Canvas 会保留原白板入口， 清空内部节点后重新构建。请先确认 Flexnote 里没有只存在于本地版本的重要修改。
• 仅补充收藏：不创建或修改笔记、白板，只把缺失的收藏入口补回侧栏。

一套更稳妥的迁移顺序

如果你的 Vault 已经用了几年，不必追求一次完成。下面这套顺序更容易检查问题：

1. 先备份 Obsidian Vault 和 Flexnote 数据；
2. 选择一个同时包含标签、双链、图片和 Canvas 的小目录；
3. 导入后检查目录、几篇复杂笔记，以及一张节点较多的 Canvas；
4. 确认结果后，再导入其余目录；
5. 后续增量导入先用「跳过已存在」，确实需要同步源文件修改时再选择「覆盖」。

导入解决的是搬家成本，不要求你立刻放弃原来的工作习惯。你可以先把 Obsidian 当作熟悉的写作环境， 把需要视觉整理的项目带到 Flexnote；也可以完整迁移后，用卡片库搜索资料，再把关键笔记放上白板重组。 先拿一小块真实资料试一遍，通常比看十篇功能对比更容易判断这套工作流是否适合你。