9.2 用Markdown和Obsidian搭好第一版
本节介绍用Markdown和Obsidian搭好第一版，并说明需要关注的操作、边界和验收方法。
搭建个人知识库，既不需要安装数据库，也不需要学习编程。只要在电脑里建一个文件夹，用最普通的Markdown纯文本来存放资料和规则，就可以立刻开始。
为什么选择纯文本Markdown文件
Markdown文件的后缀是 .md。选择它作为知识库载体，主要有三个实实在在的好处：
- 永远不被单一软件绑定：它就是最通用的纯文本。哪怕以后你换了电脑、换了笔记软件，所有内容、标题和链接都能原封不动打开，绝不会被锁死在某一家软件的私有格式里。
- AI和版本控制的原生支持：Codex可以直接秒读、秒改纯文本；配合我们在第8章学过的Git，每一处修改都能清晰对比差异，万一写错了随时能一键找回。
- 通用跳转链接：文件之间可以用标准的链接格式互相引用（比如
[查看权限检查记录](../../input/2026-06-25-权限检查.md)）。无论在哪个编辑器里，点击就能直接跳转到对应文件。
准备你的知识库阅读器（Obsidian或任意编辑器）
我们推荐使用Obsidian来浏览和查看整理好的知识库。它完全免费、不需要注册账号，笔记数据100%保存在你自己的本地电脑里（核实于2026年8月21日）。
- 打开方式：下载安装Obsidian后，点击“打开本地文件夹作为仓库”（Obsidian里的“仓库”其实就是你电脑上的普通文件夹），选中你的知识库文件夹即可。
- 简单设置：为了保持链接的通用性，建议在Obsidian的“设置 \(\to\) 文件与链接”中，关闭“使用Wiki链接”。这样插入内部链接时，它会自动生成标准的Markdown格式。
建立知识库目录与维护规则
在配套的C10案例中，我们已经为你准备好了这套知识库的标准骨架：
C10/
├── AGENTS.md # 维护规则：告诉 Codex 如何整理和更新
├── input/ # 原始资料库：存放收集来的真实业务素材
├── output/ # 知识产出库：存放 Codex 整理出的 wiki/ 页面与 log.md
├── task-input.txt # 本案例的完整任务输入
└── expected-checks.md # 验收清单其中的 AGENTS.md 是让Codex规矩干活的核心，第一版的关键规则非常简单明确：
维护目标：让Codex按固定边界维护LLM Wiki。
- input/ 是原始资料库，只读，绝不修改、移动或重命名原文。
- output/wiki/ 存放整理后的知识页面，使用标准 Markdown 链接。
- 每一个重要事实或结论，必须链接到来源页面和原始文件。
- 遇到材料缺失、新旧冲突时，必须保留“待确认”标记，交由人工判断。
- 每次新增资料、回答问题，都在 output/log.md 记下一笔日志。规则一开始不需要写得面面俱到，先跑通第一次资料整理，遇到问题再逐步完善。
动笔前：先让Codex检查规则与边界
在把大量资料交给Codex批量整理之前，最稳妥的习惯是先让它做一次只读检查，确认它完全理解了规则和权限边界：
请先读取
C10/AGENTS.md和C10/input/中的文件，只检查当前知识库的目录和规则是否足以开始第一次编入。不要新建或修改任何文件。请列出你准备读取的原始资料、允许写入的文件范围，以及发现内容冲突或缺失时你会如何处理。
如果Codex明确回答：识别出C10/input/仅供读取、只能在C10/output/中写入，并且承诺遇到冲突不会自作主张、会标注“待确认”，那就说明规则已经生效，可以放心开始后续的知识编排了。