Obsidian笔记架构:目录分解法的延伸

这是目录分解法的一次工程化延伸.建立这套物理文件夹架构的核心目的有两个:

  1. 方便快速定位问题笔记,实现结构化检索;
  2. 方便挂载与笔记相关的附属材料,包括代码片段,图片,PDF文献,工程文件等.

Obsidian笔记本质上就是一个本地文件夹,我在实践中演化出了几种典型架构.

在往下讲之前,得先分清一个层级问题:架构其实分两层——库根层管的是「整个仓库的顶层怎么切」,项目内部层管的是「一个笔记项目自己怎么装」.这两层互相独立,可以自由组合.下面先说项目内部层的三种,再回过头说库根层的两种.

方法溯源:《Obsidian关系图谱,图论与复杂网络》

架构一:分离式架构

这是工程化属性更强的架构,核心逻辑是导航层与内容层物理分离.

结构组成

进入主题笔记文件夹后,分为三个独立部分:

  1. 根目录MOC导航页:整个主题的总入口,一级内容导航.
  2. 二级MOC文件夹:存放章节级别的MOC文件,这些MOC再通过双链连接到最底层的原子笔记.
  3. 原子笔记文件夹:按照章节分类存放最细粒度的原子笔记,以及对应的附属材料文件.
主题笔记/
├── 主题笔记.md              # 根目录MOC导航页
├── 二级导航页/               # 章节级MOC
│   ├── 第一章.md
│   └── 第二章.md
└── 内容页/                   # 原子笔记 + 附属材料
    ├── 第一章/
    │   ├── 概念A.md
    │   └── 原文.pdf
    └── 第二章/

两种实现:文件夹级与文件级

同样是「导航与内容分离」,物理上其实可以落在两个不同的粒度上:

  • 文件夹级:单独建一个导航文件夹(二级导航页/ 或 导航页/),与 内容页/ 并列.这一路分离得最彻底.
  • 文件级:不另开文件夹,直接在类文件夹里放一个同名索引笔记,与子文件夹并列——比如某个 NN_MM 主题名/ 目录里,同时躺着 NN_MM 主题名.md(索引)和若干章节文件夹.

文件级落到目录上,长这样:

NN_MM 主题名/
├── NN_MM 主题名.md       # 同名索引笔记,与章节文件夹并列
├── 第一章/
├── 第二章/
└── ...

两者要解决的问题是同一个,只是权衡点不同:前者结构最清晰,代价是多一层目录,从导航到内容多一次跳转;后者不破坏树状层级,代价是索引文件与内容同级,只能靠命名区分.

核心优势

导航结构和内容文件物理分离,非常方便加入之前整理好的独立材料文件,比如代码工程,原始数据,图片素材,PDF文献等,不会打乱笔记的导航体系. 适合有大量外部附属文件的主题,比如编程学习,数理推导,带实验的学科.

架构二:树状架构

这是最贴合书籍目录分解的原生架构.

结构组成

完全按照书籍的目录层级嵌套文件夹,从总目录→章节→小节,一级一级向下嵌套,每一层文件夹里放对应层级的笔记. 和目录分解法的逻辑完全一一对应,是最直观,最符合直觉的文件夹结构.

某门课笔记/
├── 某门课.md                # 全书总MOC
├── 第一章/
│   ├── 第一章 MOC.md
│   ├── 第一节.md
│   └── 子小节/
│       └── ….md
├── 第二章/
└── 第三章/

存在的问题

缺点也很明显:层级一旦控制不好,笔记的层级很容易混乱;嵌套过深之后,文件路径变长,检索和移动成本都会上升. 而且纯树状文件夹天然割裂跨章节的知识关联,这是树状结构绕不开的通病.

相关讨论:《Obsidian关系图谱,图论与复杂网络》

架构三:平铺式架构

一个文件夹里直接平铺若干篇原子笔记,不再往下分层.

某主题文件夹/
├── 随笔一.md
├── 随笔二.md
├── 观察记录.md
└── 资源索引.md       # 篇数一多,就靠它兜底

它的逻辑其实是「不分层」:如果这些笔记之间本来就是并列关系,硬按目录分解套一层,只会造出一堆「里面只有一个文件」的空壳文件夹,反而更难找.

比较适合索引,随笔,短论这类内容——工具方法,现象观察,资源索引这些主题,篇与篇之间没有从属关系,平铺反而是最诚实的结构.

代价是:一旦某个文件夹里的笔记攒到几十篇,纯靠滚动就开始吃力,这时候必须靠索引笔记(或者 Dataview 这类的动态查询)来兜底,否则等于没有导航.

补充:库根层的两种切法

上面三种说的都是「一个项目内部怎么装」.把视角抬到整个仓库的顶层,还有两种切法.

其一:学科岛式

根目录直接是一串学科名文件夹,笔记项目藏在大纲层里.多学科的系列仓库多是这个形态.

仓库根/
├── 学科A/
│   └── 大纲/
│       └── 某门课/
│           ├── 导航页/
│           └── 内容页/
├── 学科B/
│   └── 大纲/ …
└── 学科C/                # 还没学到,先占个空槽位

需要说明的是,这些学科文件夹里有相当一部分是提前开好的空槽位——某个分支还没学到,文件夹就已经建在那里了.这正是「空壳占位法」在库根层的体现:先把位置占下来,再用跨库链接把交叉点锚定上去.所以看到空目录不代表架构坏了,它只是还没填.

其二:编号分区式

根目录是一串带数字前缀的「功能区」,比如 00 工作区 / 01 项目库 / 02 知识库 …… / 06 归档区.分区的语义是工作流阶段或主题岛,而不是任何一本书的目录.流程型,素材型的仓库常走这一路.

仓库根/
├── 00 工作区/
├── 01 项目库/
├── 02 知识库/
├── 03 资源索引库/
├── 04 …
├── 05 …
└── 06 归档区/

编号的好处有两个:一是排序固定,二是能留插入位——比如用三位编号,005,015 随时可以插进去,不用重排已有目录.

工程思维与Obsidian的破局

我发现自己的工程思维忍不住发作,哪怕在笔记建设里,也会本能地形成清晰的文件夹结构意识,所以还是把它整理出来了.

而Obsidian真正的价值,恰恰就在这里体现出来: 双链就是用来打穿文件夹结构壁垒的.

物理文件夹负责做粗粒度的文件归档,素材分类,维持本地文件系统的整洁; 双链负责做知识层面的关联,跳转,组网,打破层级和文件夹的边界.

两者一硬一软,一静一动:

  • 文件夹结构给了知识物理上的秩序;
  • 双链给了知识网络上的活力.

既满足了工程思维对结构整洁的需求,又不会被死板的层级困住知识的关联.这也是Obsidian比纯文件夹式资料管理强大的核心原因.

相关实践:《笔记记录的相关讨论》·《关于Obsidian使用现状这件事》
案例续篇:笔记架构的五种形态:以「树状」与「分离式」两个实践样本为例
架构延伸:《学科交叉的空壳占位法与前置接口策略》
进阶方案:《基于GitHub的笔记共享》

我推荐直接废掉文件夹结构,这样直接使用双链来作为链接方式最好,文件夹本质是索引,但可以上级替代

额,你这个评论能够成立的前提是,仓库本身是从零开始新建的,而不是从原来的,充满各种各样文件和资料(包括*.pdf,*.py,*.m,*.lean,*.mb,*.png)这种多模态的资料仓库改造而来的.
顺便说一下,虽然你说把文件夹拆掉,但是如果遇到如Python项目库或LEAN项目库,那就是灾难了,因为文件夹在这里的作用是接口:Lean 的 import 路径,Python 的包结构,Maya 的相对引用都直接吃目录层级,扁平化之后跑不起来.所以「废掉文件夹」的适用范围是「只有 markdown 的库」,不是「所有库」.

顺便说一下,我不是说这方法不好 —— 杂谈那块我就是平铺的,纯 md,只靠链接找,用着没问题.我反对的只是把它推成全局规则:一旦库里有被外部工具吃路径的东西,扁平就没法用.所以是范围问题,不是优劣问题.

嗯嗯,当然我也不是全部平铺,比如pr的项目我也放在笔记库(方便同步),也因为软件限制而使用文件夹,如果软件要求的话肯定还是老老实实按软件使用就行

笔记库更新是正常且阵痛的,每天更新一点点就行,实际上我们笔记库也经常因为思想进化而时常更新

恭喜你悟到了图书馆学中的分类法 :rofl:

但是一般人很难构建出一个完美的分类树。因为它是一门实践科学,里面有迭代了百余年的弯弯绕绕。

这其实也是图书馆学的一个比较典型的方法了。就比如图书馆里书都是按分类罗列好的,这是方便用户存取;同时书里通过引用(可以理解为纸面的链接)来让不同书籍之间的知识关联起来。

其实所有软件、哪怕纸笔都能做到上述效果(文件夹管理,通过内容引用来指向相关的文件)。只不过Obsidian为代表的双链笔记软件把这个引用关系显性化、可视化了,让用户在知识间跳转来得更方便。

2 个赞

补充:这些仓库究竟是怎么长出来的

前面讲的都是「结构长什么样」.这一节讲它是怎么来的.因为它不是设计出来的,是几个外部约束一点点逼出来的形状.

起因不是笔记,是数学

2026 年 3 月 24 日,我入坑 Obsidian.当时正在自学数学,看网课时知道了这个东西,就下载了.当时打算平地起家 —— 新建一个空仓库,从零开始规划目录.

然后就卡住了.卡住的不是结构,是两个很小的问题:笔记该放在哪,以及写完的笔记怎么最快地跟我正在看的 PDF 对上.

这两个问题在纯笔记仓库里无解.因为我要引用的东西不在库里,每引一次就要跨出去一次;而我对着一本 PDF 做的笔记,如果和那本 PDF 不在一棵目录树里,这个仓库对我就是半成品.

于是我干脆试了个更直接的做法:把那个默认的空仓库废弃掉,看看能不能把一个现成的文件夹直接当仓库打开.试通了.从空仓库建好,到仓库开在数学资料上,中间隔了不到三个小时.

于是方向反了过来

从「为笔记建一个仓库」,变成「让笔记住进已有的资料里」.我把仓库直接对准了那些攒了很久的多模态资料库 —— PDF,代码,工程文件,素材全在里面.笔记不再是独立的一层,它变成这堆资料旁边多出来的一类文件.

我后来才知道,这几年到处在讲的「AI 时代的个人知识库」,说的就是这个东西.而我当时只是想让笔记和 PDF 挨近一点.

代价:多个仓库,是路径依赖的最小切分

现在的仓库不是一个,是一批.原因不是学科多,是路径依赖不兼容.

严格来说,我这些仓库不是纯笔记仓库,它们同时是图书馆和项目库 —— 里面躺着正在用的、被外部工具按路径消费的东西:数学推导的脚本,Lean 工程,Python 项目,音频工程.这些东西的相对路径一旦变了就跑不起来,而它们的相对路径是长在原来的目录结构上的.

所以仓库的边界不是按学科切的,是按「哪些文件必须共享同一套相对路径」切的.一个仓库 = 一棵能被外部工具直接消费的目录树.把两个库合成一个,就要重排路径;重排路径,就等于打断正在用的工程.

这也是为什么这个架构看起来「不够统一」:它不是规划出来的,是每遇到一个必须原地运行的项目,就在那棵树上开一个仓库.

库里怎么分,是书决定的

还有一个问题:库里面的层级从哪来.

我并没有先画一张目录树再往里填.实际过程是:一边看书一边把内容扒下来,逐条打脚注,把每条挂回书里的位置.打得久了,笔记自然就按章节堆起来 —— 书里分几层,库里就分几层.两百来篇笔记,带脚注的接近一半.

所以这套结构的形状其实不是我的,是那些书的目录的,我只是让它在 Obsidian 里又长了一遍.脚注负责把它挂回原文,结论随时能回溯到页码.

这也大概解释了「目录分解法」这个名字在我这里为什么成立:分解的对象从来是书,不是笔记.

附件的位置,取决于谁读它

附件不在同一个地方,位置由「谁读它」决定.

代码和工程文件必须跟笔记并列.它们要被外部工具按路径执行,挪进一个统一的附件夹就跑不起来.在 Python 项目的实验目录里,欧几里得算法.py 旁边就有一个 欧几里得算法.py.md 作说明 —— 命名本身就是索引,哪段代码属于哪篇笔记是看得出来的,不需要再维护一份清单.

图片,.nb,.ggb 这类只被 Obsidian 嵌入显示的,则统一收进 附件/,按类型分夹.它们的位置不影响引用,集中反而好找.

前者是接口,后者是素材.

发布出去的不是整个库,是库的文本投影

附件在库里,和附件进 git,是两回事.

库内保留全部附件,导出的目录结构才是完整的.但发布仓用白名单过滤:只让文本类(md / py / m / lean / tex / json / csv / canvas)进版本控制,二进制一律不提交.所以发布出去的不是整个库,是库的文本投影 —— 结构一样,附件按类型筛过一遍.

发布是提炼,不是裁剪

自用的库里有习题,发布版没有.但习题不是被删掉的.

习题单独放在一个顶层目录里,发布时整块不带走 —— 不用逐篇删.这也是目录划分本身的一个用处:一个区块将来要不要整块拿掉,决定了它当初该不该独立成目录.

剩下的精华则压回正文,变成对应章节下面的补充.所以发布版比自用版少的是过程,不是结论:习题,试错,脚注回原文这些属于学习轨迹的东西留给自己;读者拿到的,是那些题做出来的结果.

顺带一个副作用:压不回去的条目,通常说明正文里还缺一个概念 —— 那个概念的段落根本还没写.做一次发布,等于查了一遍缺口.

一句话总结

这几个维度都不是设计出来的:

  • 库开在哪,由路径依赖决定;
  • 库里怎么分,由书的目录决定;
  • 附件怎么放,由谁读它决定;
  • 发布带走什么,由读者需要什么决定.

四个外部约束,四个维度,没有一个是「我想好了再建」.

补充二:git 是怎么接进来的

上一条讲的是仓库的形状怎么长出来的.这一条讲工具 —— 具体说,git 是怎么被拉进来的.它不是这套架构里设计的一环,是个副产品.

初衷只是同步

接 git 的初衷很功利:两台设备,想把两边弄成一样的,顺手有个备份.当时的目的就这一个,不是为了版本控制.

真正让这件事站得住的,是库里有代码.纯笔记库接 git 是说不清的 —— 会被问「为什么不用同步盘」;但代码需要回滚,需要 diff,需要分支,这些同步盘给不了.所以代码在这里不是巧合,它给了 git 一个不可反驳的理由.

接上以后,看起来一次解决了四个问题

发布,同步,备份,版本控制 —— 四个都在.

但它们不是一个量级

  • 版本控制是本职.这是 git 唯一不可替代的地方.
  • 发布靠的是公开托管,不是版本控制本身.换成任何能被公开访问的托管都成立.
  • 同步是部分解,而且是最弱的一环.它不会替你搬未提交的改动,冲突要手工合,两端都得先 commit.文件级同步工具在这件事上完胜它.
  • 备份也是部分解,缺口还很明确:白名单只放文本进仓,所以它备的是库的文本投影,不是库 —— 附件,工程文件,素材,全在外面.

缺口由谁补

  • 素材和工程文件:双机手动拷贝,每天一次.
  • 发布:独立的发布仓,不带二进制.
  • 二进制:本来就没打算进 git,所以不缺.

一句话

一个工具,一个本职,三个搭便车.搭便车的三个各有缺口,缺口得由别的东西补.

这不是缺陷.边际成本接近零的时候,顺手拿三个部分解是划算的.但它也划了一条边界:如果哪天代码搬走了,只剩纯 md,版本控制这个理由仍然在,同步大概就该换工具了.

非常好的回复.

这里建议可以看一下我这边追加的补充,这些补充会部分揭示我的那堆Obsidian仓库究竟是怎么来的:不是平地起家,而是直接盖在原来已经有一定架构的资料库上面,借用这个现成的架构去建立笔记城市.

理解搭建了一下目前你的笔记系统,提一下感想哈

首先就是比较痛苦的就是想要理解很多概念的时候,并没有先独立定义好以及概念经常变换,所以看的有点难

整个系统让我想起来以前也有按学科和教材的阶段,自己以前也有学习其他老师的工作区序号排列,看的时候经常能引起自己摸索的回忆嘛。我的经验来说知识结构可以不用常常按照教材来,因为教材是要按照教学需要。

具体案例的话就像作者的文章哈,我也发了图片,笔记分别做了两套知识结构(资料、知识),也能感受到逻辑的不同

当然我感觉系统肯定当然是好的哈,有什么想法也可以反馈

对我来说,知识关系是无限、自由的,而且完全看自己需要,一本书能有1000个哈姆莱特,一个知识就可以提出100w个关系,也就是极度抽象的因果关系了

以这种关系最大好处就是自由,知识积累上可以零散也可以专门时间体系搭建,覆盖了日常零散感悟,以及有专题时专门的搭建

而在理解,在因果上只要你不断投入因果相关的东西,你就在增加认知

不过学科的分类树除了知识本质和使用上,还有为了教育方便培养专门人才。

所以分类是没法彻底的

所以现实也有了交叉学科的存在,以及哥德尔不完备定理的名言()

这句话基本上是对的.

因为我之前(没有很久)我就遇到了一个抽象的问题:横断学科的笔记怎么打?因为横断学科分布在多个学科里面,我被我那十几个仓库的划分给害了.

然后我就去想办法,包括但不限于使用符号链接(不好的行为),后来发现Obsidian URI这个东西,这个能够实现跨仓库链接,我这边于是就做了一个实验:从地理学仓库这边打一个URI链接到物理学仓库的天文学笔记项目的一个笔记,结果成功唤起目标仓库的对应的笔记.结果就是URI开始在我的仓库大规模使用了.

这个困境的结构类似于横断学科在院校划分下的困境,不过解决方法并不同构:Obsidian端的上URI就能够缓解;院校要缓解可能就比较困难了.

这也是分类带来的一个奇怪的现象.

嗯因为学科不是完全为了个人管理知识的,也不是为了个人使用知识的()

知识连接上我觉得可以放弃那些不纯粹的框架分类,直接以「自己需要」为起点来分类,归纳思考熟练下结构非常灵活并且重点是完全是自己可以用的哈

这个实际上是我写的杂谈的具体实施模式,因为那些杂谈实际上是自己的产出,也不方便进行划分.

当然,杂谈这个东西规模大了之后极有可能需要Dataview兜底(因为手动更新链接会变的非常困难).

dataview适合动态表格、筛选等提取工作,不过储存知识依然不是其擅长的工作

双向链接可以不只是索引,我觉得还是最好可以做成因果关系的显现,这样双链就不是一个资料的目录,永远不会过期

任何知识都会大量相关的知识,都会很大,这时可能是知识颗粒需要继续拆,可以拆分出概念,很多知识都是大量知识卡片链接。所以推荐将双链作为更有价值的映射(因果等)