用 Obsidian、Hugo 和 GitHub Pages 搭建从私密笔记到公开网站的发布流程

Tue, 21 Jul 2026 09:11:29 +0800

最近，我重新搭建了个人网站。出发点很简单：

继续把 Obsidian 作为私密内容的唯一可信来源，只从中挑选适合公开的笔记，发布到一个干净的个人网站上。

这篇文章与其说是 Hugo 教程，不如说是在讨论一个问题：私密知识库与公开网站之间的发布边界，究竟该怎么划定。

下面记录的是我最终采用的架构、做过的取舍，以及实际的发布流程。

文中的仓库名、URL 和网站页面都来自我自己的配置。如果你也想采用这套方案，请换成自己的 GitHub 用户名、仓库名、域名和导航结构。

最终，我搭出了一条从私密内容通往公开网站的发布管线：

它实现了这些效果：

为什么我没有直接从 Obsidian 发布链接到标题

很多教程都建议直接发布 Obsidian 仓库里的内容。

但我没有这么做。

因为我的 Obsidian 仓库不只是写作空间，还是我的私密知识系统。

里面有这样的目录：

00-Inbox/
Projects/
Career/
内部笔记/
随想/

如果直接从仓库发布，就会带来边界问题：

比如这篇笔记：

00-Inbox/Kafka 设计.md

最终可能对应这样的公开路径：

/posts/00-inbox/kafka-design/

我不希望公开网站照搬自己梳理思路时使用的内部结构。

因此，我加了一层中间边界：Publish/。

这个目录是可公开内容的一份干净投影。

最终的架构将写作结构与发布结构分开了。

事实证明，这是整套方案中最关键的设计决定：私密仓库仍然可以围绕思考与整理来组织，公开网站接收到的则只有干净、适合发布的 Markdown。

先安装 Hugo。