跳转至

搭建一个简单的 Obsidian 知识库

本节将向读者展示如何从头创建一个简单的知识库。

在电脑中，避开你的系统文件夹，选择一个空文件夹，以 Obsidian 打开，就有了一个空空如也的知识库。

Obsidian 的布局和 VS Code 类似：左侧浏览文件和使用快捷工具，中间编辑当前笔记，右侧可以放置属性、出链、反向链接和局部关系图。

Markdown 是 Obsidian 的默认语言。除 Markdown 外，Obsidian 也支持常见图片、HTML 和 PDF 等文件的浏览。

Obsidian 的主要界面区域

1. 知识库的适用范围

知识库适合围绕一个能够长期生长的核心主题组织内容。这个主题可以是个人研究方向、某个长期项目，也可以是一套课程与实践记录。清楚的主题边界可以让目录、链接和 Agent 的搜索范围保持稳定。

一条常见的知识流是：

外部材料
  → raw 原始材料
  → sources 来源笔记 / entities 稳定实体
  → topics 跨来源主题知识

raw/ 保留可以回看的原文和附件，wiki/ 保存经过整理的内容。这样既能追溯结论来自哪里，也能让 Agent 优先读取更短、更稳定的知识笔记。

2. 一个可持续维护的目录结构

下面的结构来自作者当前使用的 SilentField 知识库。新手可以从这套最小骨架开始，再随着内容增长增加更细的目录。

SilentField/
├── .codex/
│   └── skills/              # 当前知识库专用的 Skill
├── assets/
│   ├── images/              # 全库图片
│   └── templators/          # Obsidian Templator 模板
├── raw/                     # 保留原始材料
│   ├── articles/
│   ├── notes/
│   ├── tweets/
│   └── videos/
├── wiki/
│   ├── sources/             # 以单一材料为中心的来源笔记
│   ├── entities/            # 人物、机构、仓库、硬件等稳定对象
│   └── topics/              # 跨来源形成的主题知识
├── scripts/                 # 可重复执行的维护脚本
├── README.md                # 全库入口
├── WORKFLOW.md              # 采集、整理和复核流程
├── .wiki-schema.md          # 目录、字段和路由规范
├── AGENTS.md                # Agent 的长期工作规则
└── log.md                   # 结构调整与维护记录

2.1. 四类核心内容

位置 保存什么 例子
raw/ 原始正文、转写、附件与临时记录 网页剪藏、视频字幕、手写草稿
wiki/sources/ 围绕单一来源的长期笔记 论文笔记、报告笔记、招聘信息
wiki/entities/ 能稳定命名和复用的对象 人物、公司、GitHub 仓库、GPU
wiki/topics/ 多个来源共同支持的主题知识 Transformer 架构、Agent Memory

同一份材料可以沿着这条链路逐步产生多个结果。例如，一篇论文原文进入 raw/，论文分析进入 wiki/sources/，作者和代码仓库进入 wiki/entities/，可复用的机制结论进入 wiki/topics/。

2.2. README 负责阅读入口

每个成熟目录都可以使用 README.md 说明本目录的用途、推荐阅读顺序和候选主题。概念笔记承担详细内容，README 负责把它们串成一条清楚的阅读路径。

次级目录可以在一个主题已经形成至少四篇成熟笔记、需要自己的阅读顺序并且还会继续增长时建立。规划阶段的题目先写入 README，等内容成熟后再创建文件。

2.3. AGENTS.md 与 WORKFLOW.md 的分工

AGENTS.md 保存长期稳定的规则，例如目录路由、命名习惯、字段格式和验收要求。WORKFLOW.md 保存一次材料从采集到整理完成的操作顺序。两者结合后，Agent 既知道“应该遵守什么”，也知道“这次应该按什么步骤做”。

3. 从最小骨架开始

第一次搭建时，先保留下面这些内容即可：

  1. 创建 raw/、wiki/sources/、wiki/entities/、wiki/topics/ 和 assets/templators/；
  2. 在根目录编写简短的 README.md，写清知识库主题和主要入口；
  3. 在 AGENTS.md 中记录目录含义、命名规范和引用方式；
  4. 准备一个通用笔记模板，统一 frontmatter 与 Abstract、Reference 等基础小节；
  5. 选择一份真实材料，完整走通一次“采集 → 整理 → 复核”。

完成第一条闭环后，再增加 Clip、Digest、论文处理和实体维护等 Skill。后续章节会展示模板、格式规则和自动整理流程。