我是如何使用 Obsidian 的【译】

14 分钟

原文:How I use Obsidian by Steph Ango

本文作者 Steph Ango 是 Obsidian 的 CEO。他在个人网站上分享了大量关于笔记方法、设计理念和数字工具的思考,其中「文件优先于应用」的理念影响了很多人。

这篇文章是他使用 Obsidian 的完整指南,涵盖了库结构、链接策略、模板设计、评分系统和发布流程。他的方法论核心是「拥抱混乱与懒惰,让结构自然涌现」——不急于分类,而是通过大量链接让关联自己浮现。

我最近也在使用 Obsidian,正在摸索如何用好这个工具。偶然发现了这篇指南,觉得他的思路很有启发,于是翻译出来分享。


我用 Obsidian 来思考、记笔记、写文章,以及发布这个网站。这是我自下而上的笔记方法,用于整理我感兴趣的事物。它拥抱混乱与懒惰,让结构自然涌现。

在 Obsidian 中,「库」(vault)就是一个文件夹。这一点很重要,因为它符合我「文件优先于应用」的理念。如果你想创造经得起时间考验的数字资产,它们必须是你能掌控的文件,采用易于检索和阅读的格式。Obsidian 给了你这种自由。

以下内容并非教条,只是 Obsidian 使用方式的一个示例。取你喜欢的部分就好。

库模板

  1. 下载我的库或从 Github 仓库克隆
  2. .zip 文件解压到你选择的文件夹
  3. 在 Obsidian 中将该文件夹作为库打开

主题与相关工具

个人规则

我在个人库中遵循的规则:

  • 避免将内容分散到多个库中
  • 避免用文件夹来组织内容
  • 避免使用非标准 Markdown
  • 分类和标签始终使用复数形式
  • 大量使用内部链接
  • 日期格式统一使用 YYYY-MM-DD
  • 评分使用 7 分制
  • 每周只保留一个待办清单

保持一致的风格可以将未来数百个决策压缩成一个,让我更专注。例如,我总是用复数形式的标签,这样就不用纠结新标签该怎么命名了。选择让你舒服的规则,把它们写下来。制定你自己的风格指南。规则随时可以改。

文件夹与组织

我很少使用文件夹。我避免使用文件夹,因为我的很多条目属于不止一个思维领域。我的系统以速度和懒惰为导向——我不想承担「该放哪里」的思考负担。

我不使用嵌套的子文件夹。我很少用文件浏览器来导航,主要通过快速切换器、反向链接或笔记内的链接来跳转。

我的笔记主要通过 categories 属性来组织。借助 Obsidian 的 Bases 功能,分类可以展示相关笔记的概览。

我的大部分笔记都在库的根目录,而不是某个文件夹里。我在这里写关于我个人世界的内容:日记、文章、常青笔记和其他个人笔记。如果一条笔记在根目录,我就知道这是我写的,或者与我直接相关。

我使用的两个参考文件夹:

  • References:用于记录存在于我个人世界之外的事物——书籍、电影、地点、人物、播客等。始终以标题命名,如 Book title.mdMovie title.md
  • Clippings:用于保存他人写的内容,主要是文章和论文

三个管理文件夹的存在是为了让它们的内容不出现在文件导航中:

  • Attachments:存放图片、音频、视频、PDF 等
  • Daily:存放日记,全部命名为 YYYY-MM-DD.md。我不在日记里写任何内容,它们存在的唯一目的是被其他条目链接
  • Templates:存放模板

可下载版本的库中有两个文件夹是为了方便理解。在我的个人库中,这些笔记会放在根目录,而不是文件夹里:

  • Categories:包含每个类别的笔记概览(如书籍、电影、播客等)
  • Notes:包含示例笔记

链接

我在笔记中大量使用内部链接。我尽量链接每个事物的首次提及。我的日记常常是意识流式的,记录近期发生的事,寻找事物之间的联系。链接常常是未解析的,意味着对应的笔记还没创建。未解析的链接很重要,因为它们是未来建立联系的面包屑。

在我库根目录的一条日记可能长这样:

我和 [[Aisha]] 去 [[Vidiots]] 看了电影 [[Perfect Days]],然后在 [[Little Ongpin]] 吃了菲律宾菜。我很喜欢《Perfect Days》里的这句话:[[下次是下次,现在是现在]]。它让我想起那篇文章……

电影、电影院和餐厅各自链接到 References 文件夹中的条目。在这些参考笔记中,我记录属性、评分和对这件事的想法。我用 Web Clipper 从 IMDB 等数据库获取属性信息。那句话对我很有意义,所以它成为了根目录中的一条常青笔记。我提到的文章在 Clippings 文件夹里,因为不是我写的。

这种重度链接的风格随着时间推移会越来越有用,因为我可以追溯想法是如何产生的,以及这些想法创造了怎样的分支路径。

分形日记与随机回顾

分形日记和随机化是我驯服知识库可能长成的荒野的方法。

一天中我会用 Obsidian 的唯一笔记快捷键,在想法出现时随时记录。这个快捷键会自动创建一个带有 YYYY-MM-DD HHmm 前缀的笔记,我可以再加上描述想法的标题。

每隔几天,我会回顾这些日记片段,整理出要点。然后每月回顾这些回顾,每年再回顾月度回顾(用这个模板)。结果是一张关于我生活的分形网络,我可以在不同的细节程度上放大或缩小。我可以追溯单个想法的来源,以及它们如何汇聚成更大的主题。

每隔几个月,我会留出时间进行「随机回顾」。我用随机笔记快捷键在库中快速随机漫游。我常常用浅层深度的本地图谱来查看相关笔记。这帮助我重温旧想法、创建缺失的链接、从过去的想法中获得灵感。这也是做维护的机会,比如根据风格指南的新规则修正格式。

有人问我这是否可以用语言模型自动化,但我不想这么做。我享受这个过程。做这种维护帮助我理解自己的模式。不要把理解外包出去

属性与模板

我创建的几乎每条笔记都从模板开始。我大量使用模板,因为它们让我可以懒惰地添加信息,这些信息以后能帮我找到笔记。我为每个类别准备了模板,顶部带有属性,用于捕获以下数据:

  • 日期:创建日期、开始日期、结束日期、发布日期
  • 人物:作者、导演、艺术家、演员、主持人、嘉宾
  • 主题:按流派、类型、话题、相关笔记分组
  • 位置:社区、城市、坐标
  • 评分:详见下文

关于属性,我遵循几条规则:

  • 属性名和属性值应尽量在不同类别间可复用。这让我可以跨类别查找,例如 genre 在所有媒体类型间共享,意味着我可以在一个地方看到科幻书籍、电影和剧集的归档
  • 模板应尽量可组合,例如 PersonAuthor 是两个不同的模板,可以添加到同一条笔记中
  • 属性名要短,打字更快,例如用 start 而不是 start-date
  • 如果一个属性将来可能包含多个链接或值,默认使用 list 类型而不是 text 类型

.obsidian/types.json 文件列出了哪些属性对应哪些类型(即 datenumbertext 等)。

评分系统

任何有 rating 的东西都使用 1 到 7 的整数:

  • 7 — 完美,必须体验,改变人生,值得专门去寻找
  • 6 — 优秀,值得重复
  • 5 — 不错,不用特意追求,但令人愉快
  • 4 — 尚可,凑合能用
  • 3 — 糟糕,能避免就避免
  • 2 — 极差,主动回避,令人反感
  • 1 — 邪恶,以坏的方式改变人生

为什么用这个评分标准?我喜欢 7 分制胜过 4 分或 5 分,因为我在好体验的高端需要更多粒度,而 10 分又太细了。

发布到网站

这个网站直接在 Obsidian 中撰写、编辑和发布。为此,我打破了上面列出的一条规则——我为网站单独建了一个库。我使用一个叫 Jekyll静态网站生成器,自动将笔记编译成网站,并从 Markdown 转换为 HTML。

我的发布流程使用起来很简单,但设置起来有点技术性。这是因为我喜欢完全掌控网站布局的每个方面。如果你不需要完全掌控,可以考虑 Obsidian Publish,它更用户友好,我的 Minimal 文档站点就用的它。

对于这个网站,我用 Obsidian Git 插件将笔记推送到 GitHub 仓库。然后通过我的托管商 Netlify 自动用 Jekyll 编译笔记。我还用自己的 Permalink Opener 插件快速在浏览器中打开笔记,以便比较草稿和上线版本。

配色方案是 Flexoki,这是我为这个网站创建的。我的 Jekyll 模板没有公开,但你可以从 Maxime Vaillancourt 的这个模板获得类似效果。Jekyll 也有很多替代品可以用来编译网站,比如 QuartzAstroEleventyHugo

延伸阅读