Obsidian 融合教程
快速入门到系统掌握

任务 A：15 分钟搭出可用知识库

1. 创建 vault：`HH-Brain`。
2. 创建目录：`kb/wiki`、`kb/tasks`、`kb/raw`、`kb/templates`。
3. 创建文件：`MEMORY.md`、`kb/log.md`、`kb/index.md`。
4. 新建 `kb/tasks/2026-04-21-first-task/index.md`。
5. 写入 `Goal / Actions / Decisions / Next` 四段。

验收标准：能从 `kb/index.md` 点击进入 first-task，且内容完整。

任务 B：20 分钟完成旧资料迁移

1. 从旧工具导出 Markdown 或通过官方导入器迁移。
2. 把历史资料先放入 `kb/raw/import-YYYYMMDD/`。
3. 挑 3 篇代表性笔记，补齐 `tags` 与 `status` 属性。
4. 建立 1 页 MOC 索引，把这 3 篇挂进去。

验收标准：搜索 `tag:#imported` 能返回刚迁移笔记。

任务 C：10 分钟做一次回滚演练

1. 随便修改一篇笔记 3 次。
2. 打开 File Recovery 查看快照历史。
3. 恢复到前一版本并确认正文回退成功。

验收标准：能稳定恢复旧内容，知道恢复入口位置。

任务 D：15 分钟发布一页公开内容

1. 选择一篇可公开笔记（无隐私信息）。
2. 开启 Publish 并创建站点 ID。
3. 发布该笔记并访问页面验证。
4. 补齐标题与描述，检查移动端显示。

验收标准：外部链接可访问，移动端排版正常。

仓库机制

• Vault 本质是本地文件夹，正文是 Markdown。
• 配置在 `.obsidian/`，建议与正文分层管理。
• 不建议仓库内嵌套仓库，链接范围会混乱。

链接网络

• 双链：`[[note]]`，标题：`[[note#heading]]`。
• 嵌入：`![[note]]`，用于复用片段。
• MOC（索引页）用于组织入口而非堆内容。

属性体系

• 统一字段：`status`、`tags`、`created_at`、`source`。
• 同名属性尽量保持同类型，避免检索失效。
• Properties 是自动化和统计的基础层。

检索最小语法

• `tag:#xxx`、`path:kb/tasks`、`file:daily`、`task:`。
• 组合搜索比“按记忆找笔记”稳定得多。
• 命名规范统一是检索质量的前提。

1) 本地优先

Obsidian 默认本地存储，离线可用，数据可迁移。

2) 链接驱动

双链 + 反向链接 + 局部图谱，形成可追踪知识网络。

3) 属性驱动

结构化属性让筛选、汇总、自动化成为可能。

4) 标签分层

建议使用嵌套标签表达层级，避免语义碎片。

5) 导入迁移

支持 Notion/OneNote/Evernote 等迁移，减少历史包袱。

6) 同步策略

先确定主同步方案和冲突规则，再接入多设备。

7) 恢复兜底

File Recovery 适合误改回滚，但不等于完整备份。

8) 插件安全

第三方插件高权限，必须小批量引入并持续审查。

9) Web Clipper

网页剪藏可结构化入库，是资料采集入口。

10) Publish 分层

发布前先划分公开层与私有层，避免信息泄露。

问题 1：搜索结果很乱

原因：命名和属性字段不统一。
处理：先统一 `status/tags/source`，再重建查询。

问题 2：多端同步冲突

原因：多端并发改同批文件。
处理：设定主设备，其他设备分时同步。

问题 3：插件导致卡顿

原因：一次启用过多社区插件。
处理：回退到核心插件集，逐个恢复排查。

问题 4：链接失效

原因：重命名后未通过 Obsidian 内部操作。
处理：用应用内重命名，避免文件管理器硬改。

问题 5：发布后暴露隐私

原因：未做公开层分离。
处理：发布前执行脱敏检查，单独维护公开目录。

同步方案

• 官方 Sync：跨平台稳定、官方支持。
• 第三方云：需关注离线可用和冲突风险。
• Git：适合版本追踪与回滚。

风险控制

• 同步前先做完整本地备份。
• 先定主设备与主库规则，再接入其他设备。
• 避免多端同时大规模改同一批文件。

Day 1-2

仓库、Markdown、链接、标签、MOC。

Day 3

Properties 与模板体系统一。

Day 4

任务沉淀闭环（raw -> tasks -> wiki）。

Day 5

检索体系与复盘机制。

Day 6

同步与备份策略落地。

Day 7

发布一个小型公开知识页并复盘。