我把 Obsidian 笔记变成了一个网站

来源类型： 实践教程
日期： 2026-06-11
标签： [obsidian, github-pages, static-site, publishing, tools]

核心论点

Obsidian 知识库积累的内容只活在本地，无法分享链接给他人。作者通过 GitHub Pages 将 Obsidian 笔记发布为静态网站，完整经历从"完全不懂 Git"到"自己的域名+HTTPS 的在线知识库"。核心认知：GitHub Pages 就是静态文件直接对外提供，不需要后端逻辑，本身就是服务器。

关键事实与发现

• 流程拆为三步：本地准备→推到GitHub→开启 Pages
• Git 是本地和 GitHub 之间传输代码的工具
• GitHub Pages 必须选公开仓库（免费账号私有仓库不能开 Pages）
• 发布后 URL 格式：https://用户名.github.io/仓库名/
• 可以绑定自定义域名（需要在域名服务商设置 DNS CNAME 记录）
• 静态站点生成器（如 Hugo/Jekyll）可以将 .md 转换为漂亮的网页
• 全程不需要编程知识，跟着步骤操作即可

实用建议

1. 安装 Git
2. 本地初始化：git init → git add . → git commit -m "初始版本"
3. GitHub 新建公开仓库，推送代码
4. Settings → Pages → 选择分支 → 等待1-2分钟
5. 可选：购买/恢复域名，设置 CNAME 指向
6. 选择静态站点生成器（推荐 Quartz 等 Obsidian 友好方案）美化页面

与已有知识的关联

• wiki/entities/obsidian
• wiki/concepts/local-first（local-first 的对立面——公开发布）