5-10 分钟快速入门(先跑通)

  1. 创建 Vault(仓库)。
  2. 建最小目录:`kb/wiki`、`kb/tasks`、`kb/raw`、`kb/templates`。
  3. 建核心文件:`MEMORY.md`、`kb/log.md`、`kb/index.md`。
  4. 新建 1 条 task,写完 `Goal -> Actions -> Decisions -> Next`。
第一原则:先跑通闭环,再扩展插件和复杂流程。

实操任务(照做即可)

任务 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. 补齐标题与描述,检查移动端显示。

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

可复制查询命令(高频)

任务追踪查询

path:"kb/tasks" (status:in_progress OR status:blocked)

今日相关查询

file:2026-04-21 OR path:"memory" "明日第一步"

待整理资料查询

path:"kb/raw" -path:"kb/wiki" -path:"kb/tasks"

MOC 索引漏挂查询

tag:#atomic -[[MOC]]

基础认知(必须统一)

仓库机制

  • 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 分层

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

故障排查(最常见 5 个问题)

问题 1:搜索结果很乱

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

问题 2:多端同步冲突

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

问题 3:插件导致卡顿

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

问题 4:链接失效

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

问题 5:发布后暴露隐私

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

同步与备份(安全优先)

同步方案

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

风险控制

  • 同步前先做完整本地备份。
  • 先定主设备与主库规则,再接入其他设备。
  • 避免多端同时大规模改同一批文件。
建议:File Recovery + 外部备份 + Git 三层兜底并行。

发布清单(上线前必查)

  1. 确认公开层内容,私有笔记不进入发布范围。
  2. 检查页面中的账号、路径、截图、内部链接是否脱敏。
  3. 补齐基础 SEO:标题、描述、核心关键词。
  4. 确认移动端阅读和导航可用。
  5. 发布后做一次回归检查(链接/样式/加载速度)。

7 天逐步掌握路径

Day 1-2

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

Day 3

Properties 与模板体系统一。

Day 4

任务沉淀闭环(raw -> tasks -> wiki)。

Day 5

检索体系与复盘机制。

Day 6

同步与备份策略落地。

Day 7

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

来源依据(本地)

源包路径:/Users/hanhao/Documents/AllComic/ComicPipeline/workspace/research/obsidian-tutorial-source-pack-20260420