投研知识库搭建手册 #1：为什么我选择 Obsidian + Markdown

你有没有想过，你日常积累的那些笔记、文章、想法，怎样才能让 AI 真正「读懂」并为你所用？

前面有提到过，打算把知识库从 Notion 迁移到 Obsidian，最近花了点时间研究方案。我的知识库会多涵盖自媒体创作和技术开发两个额外板块，但搭建的方法论都是互通的。

Obsidian vs Notion

首先讲讲为什么迁移。

之前选择 Notion 的根本原因是博客的程序是基于 Notion 数据库的，一直沿用到今天。如今博客已经换成 Ghost 了，和 Notion 没半毛钱关系，不过写作习惯依然放在 Notion，自己写了个脚本工具做同步发布。

另一个原因则是现在 AI Agent 工具愈发强大了，无论是 Claude Code / OpenAI Codex 还是 GitHub Copilot。在强大的模型加持之下，能做的事情更多了。而建立一个本地知识库似乎对于这些工具而言更加方便。

Obsidian 是基于文件的，官方把它叫做「File over app」，意思是：文件数据重于软件应用。

File over App

可以这么理解：

对于 Notion 来说，你所写的所有内容都存在它的数据库，它通过一个非常复杂的技术概念给你组装起来。而 Obsidian，你的所有笔记都是存在本地硬盘的一个个 markdown 文件。

对于 AI 来说，去读取一个本地的 markdown 文件相比于调用 API 解析 Notion 返回的数据来说要容易太多了。

这里所说的 AI，指的是安装在本地的 AI Agent 软件，比如 Claude Code 这些。

Notion vs Obsidian

非得是 Obsidian 吗？

其实本地的知识库，核心是你撰写的那一堆 markdown 文件，Obsidian 只是集管理、编辑、预览于一体的一个软件而已。

如果你愿意，完全可以使用 Typora（Mac 端很优雅的 Markdown 编辑器），甚至 VS Code（微软出品的写代码的编辑器）进行编辑和管理。

哪怕只是用文件夹 + 文本编辑器都行。

我选择 Obsidian 看中这几点：

高度可定制，甚至整个软件界面都可以配置，甚至使用 CSS（一种前端语言，用于定义用什么颜色、字体、排版方式渲染）做样式定制。
支持 JavaScript 开发自定义插件，插件可以在 Mac 和 iOS 端运行。
社区插件丰富，基本想要的功能都有，如果没有，自己开发或者魔改一个都很方便。
对于 iCloud 支持还可以，适合 Mac 和 iOS 双持用户。

非得是 Markdown 吗？

现有的任何模型都能很自然地读取 markdown 文件。

Markdown 文件可以看作是一个富文本的「源码形式」，也可以看作是一种非常方便的手写网页 HTML 的语言。

Markdown 原本最广泛地被用于给代码写说明书，几个 # 号、* 号、- 号，就能区分六级标题、粗体和列表。非常适合写文档说明书。

后来很多有文本输入的地方都支持了 Markdown，包括像滴答清单这样的 To-Do app。

Markdown 其实没有什么标准规范，只是大家约定俗成，它有很多「方言」。像 Obsidian 所支持的和 GitHub 所支持的，就有所差异。但我们所常用的那几个，都一样。

对于非技术出身的人来说，只需要掌握以下这些即可：

# 一级标题
## 二级标题
...
###### 六级标题

**粗体**

- 无序列表
  - 嵌套的无序列表
- 无序列表项2

1. 有序列表
2. 有序列表项2

这些对 AI 来说非常有用。AI 模型会通过多级标题来识别区分你的指令/文档的板块，会通过粗体来领会到你在强调一个事情，会通过列表来识别它要完成的 To-Do list。

AI 如何理解 Markdown

我的 Obsidian 知识库架构

规划了这样一套目录结构：

ObsidianVault/
├── 00-Inbox/                  # Webhook/接收端：存放临时剪藏、下载的研报 PDF、待处理素材
├── 10-Drafts/                 # Dev 环境 (内容)：正在撰写中的各类文案、博文草稿
├── 20-Projects/               # Dev 环境 (代码)：进行中的独立开发项目文档、脚本规划
├── 30-Outputs/                # Prod 环境：定稿的纯文本产出，供外部 Python 脚本读取分发
│   ├── innomad.io/            # 长图文：个人网站/博客文章定稿
│   └── Micro/                 # 短图文：推文串、小红书文案等短内容
├── 40-Resources/              # Dependencies (依赖库)：沉淀的原子化知识和素材库
│   ├── AI/                    # AI 相关：Prompt 模板、工具测评、工作流设计
│   ├── Dev/                   # 独立开发技术：代码片段、架构思路、iOS/扩展开发笔记
│   └── Finance/               # 投资理财：美股/期权分析、个股档案、财报阅读笔记
├── 80-Archive/                # 冷数据区：已上线的项目文档、废弃的草稿、不再关注的标的
├── 90-Journal/                # 日志与监控：时间轴记录
│   ├── Daily/                 # 每日流水：含每日交易记录、情绪复盘
│   └── Reviews/               # 周期复盘：周度/月度总结报告
└── 99-System/                 # 核心配置：系统级文件与脚本变量
    ├── Attachments/           # 附件全家桶：如果是相对路径模式，此文件夹可仅存通用配图
    ├── Templates/             # 模板库：存放标准化的 YAML Frontmatter 和排版模板
    └── _LocalConfig/          # 一些配置文件

知识库架构工作流