入门篇：为什么要用 Obsidian 搭建个人知识网站

我最开始也不是想做一个“博客系统”。

一开始只是觉得：技术问题解决了不少，Homelab 也折腾了不少，AI Agent、部署、网络、工具链这些东西都在持续试，但很多内容写完就散了。有的在 Obsidian，有的在聊天记录，有的在临时文档，有的干脆只剩脑子里的印象。

如果您也已经在 Obsidian 里或者其他笔记软件写了很多技术笔记、论文笔记、科研记录或项目复盘，可能会遇到同一个问题：内容不是没有，而是越来越难被再次使用。

时间一长，内容还在，但很难被重新找到、重新理解，也很难展示给别人。

所以真正的问题不是“要不要写博客”，而是：

您有没有一批值得长期保存、反复检索、持续更新，并且可以公开展示的知识资产？

如果有，那么个人知识网站就不只是一个展示页。它更像是给这些内容一个稳定的出口：平时仍然在本地写，整理好了再发布出去，以后自己能找回来，别人也能看懂您的积累。

1. 技术笔记需要反复检索

技术工作里有大量问题不是一次性的，这件事越做工程越明显。

今天解决一次 Docker 网络，过几个月可能又要查。今天排查一次 DNS，下一台服务器初始化时还会遇到。今天写了一段部署脚本，后面很可能还会复制、改造、复盘。

如果这些内容只留在聊天记录、临时文档或命令历史里，很快就会变成不可复用的碎片。不是你没写，而是下次需要的时候找不到上下文。

个人知识网站适合沉淀这些不一定“篇幅宏大”，但以后真的会反复用到的内容：

• 故障排查记录
• 部署过程
• 架构选择
• 工具链配置
• 性能优化
• 踩坑复盘

它的价值不在于“今天发一篇文章”，而是以后再遇到类似问题时，可以回到一篇整理过的文章里。

2. 学习过程需要被整理成路线

学习新技术时，很多人会留下大量笔记。我以前也会这样：今天记一个概念，明天记一段代码，后天又新开一个文件。

但碎片笔记不等于学习资产。

例如学习 AI Agent，可能会经历：

• LLM 基础
• Prompt 设计
• RAG
• 工具调用
• MCP
• Agent Workflow
• 项目实践

如果这些内容只是散落在 Obsidian、Notion 或本地文件夹里，后面很难看出自己到底走到了哪里。您会知道“我学过”，但很难说清“我从哪里开始、解决了什么、现在卡在哪里”。

个人知识网站可以把它组织成一条路线：

图表加载中...

这对自学、转型、研究方向积累和个人品牌都很有帮助。

3. 项目复盘比项目结果更重要

很多项目做完以后，只留下一个仓库、一个截图，或者一句“这个我做过”。

但真正有价值的，往往是过程：

• 为什么做这个项目
• 解决了什么问题
• 技术方案怎么选
• 遇到哪些困难
• 后来如何调整
• 最后沉淀了什么经验

对外展示时，项目结果能证明你做过；项目复盘能证明你想清楚过。这个差别挺大。

这对程序员、独立开发者、研究型项目、课程项目和开源项目都很重要。

4. 科研记录和论文笔记需要可追溯

科研和研究型学习很依赖长期记录。

一篇论文读完，如果只留下几句摘要，很难在几个月后重新进入上下文。一次实验失败，如果没有记录参数、假设和结果，后面很难判断问题出在哪里。

个人知识网站不一定替代正式论文或实验管理系统，但它可以沉淀：

• 论文阅读笔记
• 方法对比
• 实验日志
• 数学公式
• 图表和流程
• 阶段性总结

当这些记录被结构化发布后，它不仅方便自己复盘，也方便别人理解你的研究路径。

5. 个人能力需要一个可验证的展示面

简历、介绍页和社交主页都可以说“我会什么”。

但文章、项目复盘和长期学习路线可以让别人看到“您怎么做、怎么想、怎么积累”。

这类内容对很多场景都有价值：

• 找工作
• 接项目
• 申请实验室
• 申请学校
• 做开源项目
• 建立个人品牌

一个个人知识网站不是为了炫耀。我更愿意把它看成一个稳定的展示面：您不用每次重新解释自己做过什么，文章、路线和项目记录会替您说一部分。

6. 平台发布不等于资产沉淀

公众号、知乎、CSDN、掘金、Notion 都可以发布内容。

它们各有优点，但也有共同问题：

• 内容结构受平台限制
• 样式和阅读体验不可控
• 导出和迁移成本不确定
• 搜索和归档方式不一定适合自己
• 平台策略变化会影响长期访问

如果内容对您来说只是一次性表达，平台发布当然足够。我也不是觉得所有东西都要放到自己的网站上。

但如果内容是长期资产，就尽量保存为自己可控制、可迁移、可重新发布的格式。平台可以作为分发渠道，但最好不要成为唯一资产仓库。

这也是 Markdown 和 Obsidian 适合作为入口的原因。

7. 什么情况下值得用 Obsidian 搭建个人知识网站

如果您符合下面任意几条，就值得考虑搭一个：

• 经常写技术笔记
• 经常复盘项目
• 有长期学习路线
• 有论文阅读和实验记录
• 想公开展示自己的能力
• 不想内容被平台锁住
• 希望内容未来还能迁移
• 想用低成本长期维护个人网站

反过来，如果只是偶尔发短内容，或者完全没有公开展示和长期检索需求，就没必要急着搭建。

8. 博客只是结果，不是动机

很多人把这件事叫“搭博客”，这个说法没错，只是不完整。

但博客只是最后的展示形态。

真正的动机是：

• 保存经验
• 整理思路
• 复盘项目
• 记录研究
• 展示能力
• 降低迁移成本
• 建立长期个人资产

所以更准确的说法是：

把技术笔记、科研记录、项目复盘和学习总结，整理成一个可检索、可展示、可长期迁移的个人知识网站。

这个系列想讲的也是这件事：不是为了建站而建站，而是把已经在发生的学习、实践和记录，慢慢整理成一个长期可用的系统。