迁移指南 - Roam Research 导入 Anki
如何从 Roam Research 迁移到 Deckbase
Roam 的块级结构里藏着可直接用于复习的原子笔记，但 [[链接]] 语法和嵌套缩进需要在导入前清理。这套流程能把你的 Roam 图谱转成干净的闪卡，同时保留那些让 Roam 好用的关联。
Deckbase阅读约 7 分钟
何时使用此工作流
适合有每日笔记、文献笔记或概念图的 Roam Research 用户：他们想把高信号价值的块转成专门的间隔重复循环，而不是反复重读整个图谱。
请将此视为一项可操作的迁移流程，而不只是一次性文件上传。目标不仅是成功导入，还包括在切换后的数周内获得更好的复习一致性并降低卡片维护开销。
导入前检查清单
- 先找出哪些页面含有值得复习的内容：并非每个 Roam 页面都需要做成卡片。
- 用 Roam 的 Export All 功能把目标页面导出为 Markdown 文件。
- 决定是把 [[页面链接]] 作为上下文保留在笔记字段里，还是干脆全部去掉。
如果某项检查清单未通过，请在导入前修复。上游清理比迁移后修复数百张卡片更快。
建议的字段映射
块文本（已清理）
- Deckbase 字段
- 卡片正面或背面
- 说明
- 删除 [[方括号]]、#标签 和 ^块引用
父块上下文
- Deckbase 字段
- 笔记字段
- 说明
- 保留概念锚点，又不让卡片变得杂乱
#flashcard or #card tag
- Deckbase 字段
- 牌组标签
- 说明
- 在 Roam 里保持统一打标签，方便按标签筛选导出
页面标题
- Deckbase 字段
- 牌组名称
- 说明
- 一个页面一个牌组，复习负担更可预测
在相关牌组之间保持映射稳定。一致的结构有助于批量操作，并让后续模板编辑更安全。
分步迁移流程
- 1在 Roam 里用统一的标签（比如 #flashcard 或 #review）标记想出成闪卡的块。
- 2把页面或整个图谱导出为 Markdown：Roam 会为每个页面生成一个 .md 文件。
- 3用查找替换去掉正文里的 [[双方括号]]、^块引用 和 #标签。
- 4在表格里把已标记的块改写成正反配对：问题占一行，答案占下一行。
- 5把清理好的 CSV 导入 Deckbase，映射正面和背面列，并用页面标题作为牌组名称。
- 6先拿 20 张卡片试点，检查质量：把那些只是原子笔记、并非真正提取式问题的块重写。
常见错误与解决方法
导入前没有去掉 [[链接]]
做一次全局查找替换，删掉 [[...]] 外壳；如果链接文字对理解有用，可以保留。
嵌套块被导入成一张长卡片
在表格整理阶段把缩进的子块拆成独立卡片：一张卡片一个事实。
每日笔记里低信号内容太多
只导出你明确标记过块的页面，原始每日笔记页面直接跳过。
块引用（^abc123）出现在卡片文本里
在查找替换清理环节里替换或删除 ^块引用 锚点。
每次修复后先使用小型试点牌组。如果试点质量稳定，再将相同的修正模式应用到整批数据。
输出质量检查示例
- 正面：Roam 的核心信息单位是什么？| 背面：块，即一个可以被图谱中任何位置引用的原子段落。
- 正面：解释 Zettelkasten 中的“文献笔记”。| 背面：用自己的话对素材做的加工摘要，并与永久笔记建立链接。
- 正面：相比 SM-2，FSRS 优化的是什么？| 背面：为每张卡片自适应估算记忆稳定性，而不是使用固定的难易因子。
在质量检查期间，逐张验证示例卡片是否清晰、单一且答案准确。避免导入只考查措辞而不考查理解的卡片。
一个实用测试：如果在复习时能在 10 秒内准确作答，这张卡片通常范围恰当。如果不能，请拆分或重写它。
常见问题
用 Deckbase 就必须放弃 Roam 吗？
不用。大多数用户继续用 Roam 做笔记和收集，用 Deckbase 专门做每日复习。把想记住的块导出、导入一次，其余部分照旧保留 Roam 的工作流。
Roam 到 Deckbase 的导出可以自动化吗？
可以。如果你有 Deckbase MCP 集成，可以用 API 直接根据处理好的 Roam 导出脚本化创建卡片。如果只是一次性迁移，对大多数用户来说手动走 CSV 更快。
我应该导入整个 Roam 图谱吗？
不建议。只导入明确标记为复习用的块。导入整个图谱大多会产出低质量卡片，还会带来一个管不过来的复习队列。要有取舍：质量优先于覆盖范围。
提示：对于高级工作流，请保留原始导出文件作为备份，并按批次名称和日期跟踪每次迁移尝试。
定位的查询意图：Roam Research 导入 Anki。本指南作为实用迁移工作流页面进行审核，而非通用信息文章。