Obsidian

一句话定位：你的笔记是你硬盘上的普通 Markdown 文件，Obsidian 只是那个最好用的查看器。

这是「一天一款产品」系列的第三篇。今天讲 Obsidian。

笔记工具的品类里有一类天然让人不安：数据存在别人的服务器上，导出的时候给你一个导不干净的 HTML，或者付费才能访问自己的旧笔记。

Obsidian 用了另一种答案：笔记就是一个文件夹里的 .md 文件。没有数据库、没有私有格式、没有导入导出流程。你用系统文件管理器就能看到全部内容，用任何编辑器都能打开。

听起来像「一个 Markdown 编辑器加个侧边栏」，但它在这个基础上做了一件更难的事——让它身边的人愿意长期用下去。

这篇能回答什么

• 「本地优先」到底意味着什么，它和「本地存储」差在哪？
• Obsidian 的插件机制为什么能撑住一个几千插件的生态，而主程序几乎不变？
• 双向链接（Backlink）为什么成了这类工具的事实标准？
• Canvas 和 Bases 各自解决了什么问题，它们算不算破坏了「纯 Markdown」？

前置知识：知道 Markdown 语法；用过任何一款笔记或知识管理工具（Notion、印象笔记、Notability 等）。

它解决什么问题

第一，数据归属。 笔记是几十年的资产，而绝大多数 SaaS 笔记工具的导出体验都很糟。Obsidian 的答案是把这件事做到底：文件就是文件。

第二，双向链接。 手动加文件夹的分类体系会失败，因为同一篇笔记往往属于多个主题。Obsidian 用 [[链接]] 让笔记之间直接连起来：

今天重写了[[同步引擎]]的冲突合并逻辑，顺手记在[[分布式系统笔记]]里。

两个直接好处：

• 反向链接面板自动告诉你「谁引用了这篇」，等于一份自动维护的反向索引
• 关系图谱把整个库画出来，孤立的节点一眼可见

第三，插件。 Obsidian 的核心刻意做得很薄，几乎所有非核心功能都交给社区插件。这让「一个人用不顺手」的问题不必等官方排期——社区当天就能出一个插件。

上手路径

1. 建一个 vault（仓库）文件夹。 就是普通文件夹，建议放在你自己的同步盘或 Git 仓库里
2. 先别装插件。 用一周纯 Markdown 写，确认这套「文件夹 + 链接」的方式你真的会用。装插件是这之后的事
3. 从链接开始，不用文件夹。 写一篇就链到相关的两三篇，哪怕那几篇是空的
4. 再装插件。 按需来：日历、任务、看板、模板。装之前先问「这个功能我上个月真的缺过吗」
5. 把 vault 放进 Git。 它就是一堆文本文件，Git 天生能处理，而且顺手给你版本历史

第 2 步是最容易被跳过、也最不该跳过的一步。 大量人装了几十个插件，最后发现自己只是在维护一个插件配置，而不是在写笔记。

三个关键设计决定

一、文件格式就是产品格式

Obsidian 不用数据库，vault 就是一个文件夹：

vault/
├── 项目/
│   └── 知识库重构.md
├── 日记/
│   └── 2026-11-02.md
└── 模板/

每个 .md 文件是纯 Markdown，[[双链]] 在保存时会被保留为 [[双链]] 文本（显示成可点的链接，但在文件里仍是普通语法）。这意味着：

• 你随时可以用别的工具打开它
• 版本控制、备份、grep 全部可用
• 五年后软件不维护了，你的笔记还在

代价是它必须处理所有「数据库能做但文件做不到」的事：结构化查询、批量更新、跨库关联。Obsidian 的 Bases 就是对这道题的回应。

二、插件承担扩展，主程序保持稳定

社区插件是 Obsidian 生态的核心。每个插件是一个独立仓库、独立版本，官方只提供一套稳定的 API。

这个架构的好处：

• 主程序几乎不需要变。 十年后老插件还能跑，靠的是 API 稳定承诺
• 功能演进快。 社区当天就能做出日历、看板、任务管理，不需要官方排期
• 试验成本低。 插件坏了只影响装它的那个库，删掉就回到核心

代价是质量参差：插件的权限模型比较宽松，一个插件就能读写整个 vault；同时长期不更新主程序会让新系统特性（比如新的系统主题、新的文件 API）用不上。

三、从「文件」长出「结构」

早期 Obsidian 只有笔记和链接，是纯粹的文档工具。后来加的两个东西，方向一致：在不改文件格式的前提下，提供结构化的用法。

Canvas 是无限画布：把笔记卡片拖到画布上，用箭头连起来。它解决的是「有些关系用文字描述不如画出来」——架构图、思路草图、调研脉络。

Bases 则是给笔记加了一层数据库视图：给笔记加属性（写在 frontmatter 里），然后按属性筛选、排序、分组。

有意思的地方在于它没有走「把笔记变成数据库行」的路。文件还是那些 Markdown 文件，Bases 只是从属性里生成的一张视图。你在 Base 里看到的每一行，背后仍然是一个你可以用记事本打开的 .md。

这和 Notion 的路线正好相反：Notion 的数据库是主角，内容依附于数据库记录；Obsidian 的文件是主角，数据库是派生视图。

短板

• 上手门槛是真实的。 「vault」「属性」「插件」这些概念对新手不友好，官方文档也承认这一点
• 移动端是二等公民。 移动应用能读能写但没有插件，很多桌面端的能力在手机上不存在
• 规模大了会变慢。 几万篇笔记的库，全文索引和图谱计算会明显吃资源
• 插件依赖社区。 插件作者停止维护时，除了自己接管没有别的办法

替代方案

一句话评价

它把「你的数据属于你」从一句口号做成了默认设置，剩下的交给社区。