工程 /
如何用 Notion、Obsidian、GitHub 和 Cloudflare 搭建自己的知识网站
obsidian#发布流程#隐私#个人网站#知识管理
这个网站不是把全部笔记直接搬到互联网上，而是在原有写作习惯之外增加了一条可控的发布流程：Notion 和 Obsidian 负责写作，GitHub 保存发布版本，Cloudflare 负责把公开内容与需要登录的内容分别交付给读者。
先确定一个原则：一篇文章只有一个正文来源
我不让 Notion 和 Obsidian 相互同步。它们承担不同的写作场景，但每篇文章只选择其中一个作为正文来源。
这样可以避免同一篇文档在两个软件里同时修改，最后无法判断哪一份才是最新版本。网站也不直接扫描整个 Notion 工作区或 Obsidian 仓库，只有被明确选入发布清单的文章才会进入后续流程。
四个平台分别负责什么
Notion：整理长期知识
Notion 更适合整理结构稳定、需要持续补充的知识文档。准备发布时，我会在独立的发布索引中选择文章，并填写标题、分类、标签、状态和可见性。
同步程序只读取发布索引和被明确选中的页面，再生成一份标准 Markdown 快照。日常笔记不会因为连接了网站就被自动公开。
Obsidian：记录本地工程过程
Obsidian 主要用于工程记录、实验过程和本地 Markdown 文档。需要发布时，只选定具体文件并复制一份发布快照，不扫描整个资料库，也不会顺着文内链接自动上传其他笔记。
发布快照与原始笔记分开保存，所以整理网页格式不会反过来破坏正在使用的工程记录。
GitHub：保存发布版本和变化历史
GitHub 保存标准化后的 Markdown、图片、发布清单和版本历史。每次更新都可以看到改了什么，出现问题时也能找到此前正常的版本。
GitHub 在这里是发布中介和版本仓库，不是私密网页的访问控制。即使内容仓库本身是私有的，真正向浏览器提供私密文章时，网站仍然需要独立的身份验证和服务端权限检查。
Cloudflare：构建后的托管、鉴权与设置
Cloudflare 承载最终生成的网站。公开站可以直接访问；包含私密文章、私密搜索索引和管理功能的站点则放在登录保护之后。
网站的少量公共设置可以保存在独立数据库中，例如主页文字、默认背景和界面透明度。正文依然保留在内容发布流程里，避免把文章、账号设置和访问权限混在一起。
一篇文章如何从笔记变成网页
整个流程可以压缩成七步：
- 在 Notion 或 Obsidian 中完成原文。
- 明确选择需要发布的单篇文档，不扫描整个知识库。
- 在发布清单中填写稳定标识、标题、分类、标签、状态和公开或私密属性。
- 将原文转换或复制为标准 Markdown 快照，并检查图片和内部链接。
- 运行内容校验，确认文件存在、标识没有冲突、可见性值有效。
- 分别生成公开构建和登录后构建，再检查全文搜索索引。
- 确认公开包中没有私密标题、正文、地址或索引后，再部署到 Cloudflare。
这里最重要的不是“自动同步得多快”，而是每一步都能知道哪些内容正在被发布。
公开内容和私密内容如何分流
发布清单是两条构建路线的共同入口，但它们读取的范围不同。
- 公开构建只接受状态为“已发布”并且可见性为“公开”的文章，公开全文搜索也只索引这些内容。
- 登录后构建可以同时包含公开文章和私密文章，并建立独立的全文索引。
- 登录只是第一层检查，服务端仍要验证当前身份是否在允许范围内。
- 管理员可以修改文章可见性，但修改后必须重新构建并检查部署结果，不能只在浏览器里把入口隐藏起来。
因此，私密内容不会先发送到未登录浏览器再用界面遮住，也不会依赖难猜的网址、noindex 或前端密码来保密。
如何更新、撤回和保留历史
文章更新后，重新生成快照并构建网站。GitHub 保存每一次明确发布的版本，Cloudflare 负责交付当前通过检查的构建结果。
如果文章暂时不再展示，可以把状态改为归档；如果要从公开改为私密，需要重新生成公开站，确认公开页面和公开搜索索引都不再包含它，同时检查旧公开副本的处理方式。原始文档不必删除，仍然留在它自己的写作工具中。
如果从头搭建，可以按这个顺序开始
- 先选一个静态网站框架，只实现 Markdown 阅读、分类和搜索。
- 建立统一发布清单，把正文来源、状态和可见性从页面代码中分离出来。
- 先完成“公开构建绝不包含私密文档”的自动检查。
- 再增加登录站和服务端身份验证，不使用纯前端隐藏方案。
- 接入 Notion 和 Obsidian 时坚持显式选文、最小读取范围和发布前快照。
- 最后再增加背景、主题、管理设置等体验功能。
这个顺序的好处是，网站即使还不够漂亮，内容边界也从一开始就是清楚的。
结语
这套流程的目标不是把所有资料集中进一个软件，而是让不同工具继续做各自擅长的事，再通过一条可检查、可回滚的发布链路连接起来。公开内容方便分享，私密内容需要身份验证，所有真正发布过的版本都能留下记录。