基础篇：Obsidian 个人知识网站能做什么

如果您正在寻找一种把 Obsidian 笔记发布成个人网站的方式，重点不只是“能不能生成网页”，而是能不能把技术笔记、科研记录、项目复盘和学习路线组织成长期可用的知识资产。

本站不只是一个展示文章的博客。

它更像一个围绕 Markdown 和 Obsidian 构建的个人知识资产发布系统：内容先在本地沉淀，再通过网站变成可以阅读、检索、关联和长期展示的知识资产。

这套工作流尤其适合长期写技术笔记、科研记录、项目复盘和学习总结的人：既能记录工程实践、实验过程、论文笔记、图表和数学公式，也能把长期积累发布成一个可被检索、可被引用、可持续更新的个人网站。

它的目标不是替代所有笔记软件，也不是做一个复杂 CMS，而是解决一个更具体的问题：

如何把一个人的长期学习、实践、项目和总结，稳定地沉淀下来，并低成本发布成自己的个人网站。

一、Obsidian 个人知识网站能做什么

1. 内容仍然属于您

本站内容以 Markdown 为核心。

一篇文章不是被锁在某个后台数据库里，而是由 Markdown、Frontmatter 和附件组成。

这意味着内容可以长期保存，也可以迁移到其它工具：

• Obsidian
• GitHub
• Hugo
• Astro
• Jekyll
• MkDocs
• GitBook

即使未来不再使用这套系统，内容资产仍然完整存在。

2. 文章、标签、系列和探索方向同时组织

本站不是简单地按发布时间堆文章，也不把公开阅读入口设计成一层层文件夹目录。

真实的知识沉淀通常不是一开始就成体系的。

很多时候只是先探索一点点：今天记录一个命令，明天整理一次排障，后天写一篇项目复盘。刚开始这些内容可能只是几篇独立文章，还没有必要强行整理成完整路线。

等同一方向的内容越来越多，才会慢慢演进出系列。比如 Homelab 一开始可能只是服务器选型，后来有 PVE、网络、DNS、Tailscale、Docker、备份和自动化运维，这时再把它组织成一条 Homelab 建设系列就比较自然。

目录层级适合在 Obsidian 里管理原始文件，比如按 articles、projects、growth、attachments 分开存放。但目录有一个问题：一篇内容通常不只属于一个位置。

比如一篇 Homelab 网络实践文章，放在 Homelab 目录里没问题，但它同时也和 PVE、Docker、DNS、Tailscale 有关。只放在某一个目录里，就很容易让其它关联关系消失。

标签解决的是这个问题。它不要求您先判断“这篇文章到底放进哪个目录”，而是允许一篇文章同时拥有多个主题入口。

所以公开站更适合用四种组织方式：

• 文章：记录一次完整实践或思考
• 标签：横向连接同主题内容
• 系列：纵向组织一条学习或建设路线
• 探索方向：说明这些产出长期在靠近什么问题

例如 Homelab 相关内容，可以既出现在文章列表里，也可以通过 PVE、Docker、Network 等标签被检索，还可以被组织成一个完整的 Homelab 建设系列。

探索方向比系列更上层一点。 它不是目录，也不是计划进度，而是一段长期问题意识。比如“个人知识资产发布系统”，关注的是如何把本地笔记、公开站、私有 Hub、服务器和发布插件连接成一套可长期使用的工作流。

一开始，这个方向下面可能只有几篇零散文章；内容越来越多以后，其中一部分会沉淀成系列。也可能有些文章暂时不属于任何系列，但仍然属于同一个探索方向。

所以探索方向可以直接关联文章，也可以通过系列关联文章。

一篇文章可以关联多个探索方向。因为同一次实践可能同时服务几个长期问题，比如一篇 Obsidian 插件发布文章，既可能属于“个人知识资产发布系统”，也可能属于“工具效率优化”。

和系列一样，探索方向不是每篇文章都要填写的字段。普通文章可以只写标题、摘要、日期和标签；当一篇文章确实属于某个长期问题，再补上探索方向即可。没有探索方向的文章仍然会正常出现在文章列表、标签页和搜索结果里。

系列则建议保持一个。系列表达的是一条连续阅读路线：这篇文章在这条路线里排第几篇，上一篇和下一篇是什么。如果同一篇文章正式放进多个系列，排序和阅读路径会变得混乱。遇到跨系列内容，更适合用标签和探索方向来关联。

以本站这个系列为例：

• 探索方向：个人知识资产发布系统
• 系列：Obsidian 搭建个人知识网站：从本地笔记到公网发布
• 文章：为什么要搭建、能做什么、日常发布工作流、内容规范、公开站和私有 Hub 架构
• 标签：Obsidian、Markdown、Search、Deploy、Open Source

这样物理目录负责本地存放，文章负责完整表达，标签负责横向检索，系列负责阅读路线，探索方向负责长期脉络。

这种结构更适合渐进式探索，而不是一开始就要求所有内容都有完整分类。内容越多，越不能只靠目录层级来组织。

3. 文章目录和关联阅读

文章页支持右侧目录，读者可以快速理解文章结构，并在阅读时看到当前章节位置。

文章左侧提供关联阅读：

• 如果文章属于某些探索方向，会显示相关的探索方向
• 如果文章属于某个系列，会显示系列位置和上一篇、下一篇
• 如果文章有标签，可以点击标签查看同标签相关文章
• 相关文章数量过多时只展示最近几篇，更多内容跳转到标签页

右侧目录解决“本文怎么读”，左侧关联解决“接下来读什么”。

4. 全文搜索和知识找回

本站支持全文检索。

读者可以搜索：

• 标题
• 摘要
• 正文
• 标签
• 系列
• 探索方向

这让网站不是一个只能按时间翻找的博客，而是一个可以被反复查询的个人知识库。

5. 图表、表格和代码友好

技术内容经常不只是文字。

本站支持：

• Mermaid 图表
• Excalidraw 图片展示
• KaTeX 数学公式
• PDF、Office、ZIP 等下载附件
• MP3、M4A、OGG、WAV 音频播放
• 外部视频链接卡片
• 代码块复制
• 长代码块滚动
• 表格横向滚动
• 脚注悬浮查看
• Markdown Callout

这些能力让复杂技术文章、科研笔记、算法推导和实验记录更容易阅读。

例如，行内公式可以写成 $E = mc^2$，块级公式可以写成：

$$\int_0^1 x^2 \, dx = \frac{1}{3}$$

对需要记录论文阅读、机器学习、数学推导、工程指标和实验数据的人来说，公式能力不是装饰，而是基础能力。

6. Obsidian 本地写作和发布

理想的使用方式不是打开源码、运行命令、手动上传文件。

日常发布只需要：

图表加载中...

Obsidian 插件会把发布时检查、附件同步、构建和发布封装起来。

7. 公开站和私有 Hub 分离

长期写作时，内容往往不只有“公开”和“不写”两个状态。

一个长期知识系统里，很多东西会处在中间状态：已经有价值，但还不适合公开；自己需要经常用，但没必要展示给所有人；项目还在做，暂时只想自己预览。

所以这里会把公开站和私有 Hub 分开。

公开站是给外部读者看的页面。它适合放已经整理好的文章、系列、标签页、搜索页和关于页。别人访问公开站时，看到的是你愿意长期展示的内容：技术文章、科研记录、项目复盘、学习路线和公开作品。

私有 Hub 更像自己的工作台。它不一定承担公开展示，而是保留一些自己日常会用的能力：

• 草稿预览：文章还没公开前，先看发布后的真实效果
• 私人应用入口：例如健身、记录、工具类小应用，只给自己使用
• 内部统计：查看文章访问、分享、短链等运行状态
• 未公开内容：还在整理中的笔记、阶段材料和临时页面

这里说的“私人应用”，不是这套系统内置的一堆复杂应用，也不是使用前提。它更像一个入口位：如果您后续通过 vibe coding、低代码工具或自己写一点代码做了小工具，可以把它们挂到 Hub 里集中访问。

比如训练计划、体重记录、资料索引、临时分享页、内部管理入口。这些工具的来源可以很灵活，可能是自己写的，也可能是 AI 辅助生成的，也可能只是一个外部服务链接。Hub 只负责把这些入口收拢起来，并和公开站隔离开。

公开站解决的是“对外展示和被搜索”的问题。

私有 Hub 解决的是“自己管理、预览和使用”的问题。

两者分开后，公开内容不会被草稿、私人工具和内部状态污染；私人工作台也不用为了好看而迁就外部读者。一个站点既可以作为公开作品集，也可以保留自己的日常知识工作台。

8. 低成本服务器部署

本站的基础形态是静态站。

实际使用时，需要准备一台 Linux 轻量服务器。网站文件由服务器上的 Nginx 对外提供访问，Markdown 原文、图片附件和后续 Hub 能力也放在同一台服务器上统一管理。

对个人来说，低成本很重要。一台最便宜的 Linux 轻量服务器就可以跑起来，一年成本可以控制在不到 100 元。

因为个人知识资产不是一个短期活动，而是一件可能持续很多年的事情。

低成本意味着这件事可以长期做，不会因为平台订阅、复杂云服务或昂贵服务器而中断。

9. 远程知识云盘和资料备份

这套系统不只是在公网展示文章。

它也可以把服务器当作一个轻量远程知识云盘：

• Markdown 原文
• 图片附件
• Excalidraw 源文件
• 图表导出文件
• 学习资料
• 项目文档

这些内容可以保存在本地，也可以同步到自己的服务器。

公开站负责展示整理后的内容，私有空间负责保存仍在沉淀中的资料。这样既能发布，也能备份。

10. 技术资产可以无损迁移

这是 Markdown First 最大的价值。

内容不是被写进某个封闭数据库里，而是普通文件：

Markdown
Frontmatter
附件

如果以后不再使用这套系统，内容仍然可以迁移到：

• Hugo
• Astro
• Jekyll
• MkDocs
• GitBook
• GitHub 仓库
• 其它 Markdown 工具

这意味着真正拥有的是自己的技术资产，而不是某个平台里的一个账号。

二、谁会真正用到它

本站的工作流适合这些场景：

• 长期写技术笔记
• 使用 Obsidian 记录知识
• 整理论文阅读笔记和实验记录
• 复盘项目、工程实践和学习路线
• 想把学习过程沉淀成公开作品
• 想低成本拥有个人网站
• 希望内容可迁移、不被平台锁定

它不适合这些场景：

• 完全不想接触 Markdown
• 需要多人协作审批流
• 需要复杂电商、会员或社区功能
• 希望所有内容都依赖一个在线后台

三、相比常见方案有什么优势

方案	优点	局限	本站的差异
普通博客	简单、易展示	内容容易按时间堆积，长期结构弱	同时支持文章、标签、系列、关联阅读和搜索
云笔记	写作方便，同步容易	对外展示弱，迁移和自定义受平台限制	本地 Markdown 保存，网站负责发布和展示
传统 CMS	后台完整，适合多人管理	运维重，内容常被数据库绑定	用 Markdown 作为资产，不把内容锁进系统
静态站主题	性能好，成本低	往往要理解源码和构建	目标是通过 Obsidian 插件降低发布门槛
纯 GitHub Pages	开放、可迁移	非技术背景使用门槛高	保留开放性，同时补齐写作、校验和发布工作流

本站的优势不在于“功能最多”，而在于这几个取舍：

• 内容资产可迁移
• 写作入口贴近 Obsidian
• 发布成本低
• 结构适合长期成长
• 技术内容阅读体验更完整
• 公开展示和私有工作台可以分离

四、一句话总结

本站想做的是：

让个人用 Markdown 和 Obsidian 管理长期知识资产，并低成本发布成一个属于自己的个人网站。

它不是一个短期展示页，而是一个面向长期学习、长期实践和长期沉淀的个人知识系统。

它的核心好处是：

• 本地写作
• 插件发布
• 低成本部署
• 远程备份
• 公开展示
• 全文检索
• 公式和图表支持
• 技术资产无损迁移