目标
用 GitHub 搭建一套自己的知识库：本地用 Obsidian 写，Git 管版本，网站只展示我选择公开的笔记。
架构
Obsidian（写作）→ Git 私有仓库（存储）→ Cloudflare Pages（构建发布）→ 网站
- 静态站点生成器： Quartz 4，原生支持双链、反向链接和关系图谱
- 公开策略： 私有仓库 +
publish: true才发布 - 目录结构： 见 如何使用这个知识库
进展
- 确定选型：Quartz + 私有仓库 + Cloudflare Pages
- 初始化 Quartz，配置中文和发布过滤
- 创建 GitHub 私有仓库并推送
- 用 Obsidian 打开
content文件夹 - 配置 Cloudflare Pages 部署
- 安装 Obsidian Git 插件，实现自动同步
- 绑定自定义域名（可选）
决策记录
| 日期 | 决策 | 原因 |
|---|---|---|
| 2026-10-25 | 选 Quartz，不选 MkDocs | 主要记个人笔记，需要双链和关系图谱 |
| 2026-10-25 | 私有仓库 + 部分公开 | 草稿默认不公开，以后切换到完全私有也方便 |
| 2026-10-25 | 推送凭据只在本仓库单独配置 | 不影响公司项目使用的账号（细节记在私密笔记里） |
复盘
- 浅克隆（
--depth 1）的仓库不能直接推送到新仓库，要先git fetch --unshallow。 - 推送包含
.github/workflows/的提交，需要授权里有workflow权限。