00 · 给新人的速览
5 分钟看完，知道这事是什么、要花多少钱、要花多少时间。
适合谁：朋友看到我的博客问"你是怎么搭的？"——直接把这页发过去就行。
一、宏观技术架构（一张图看懂）
你写 markdown 文件（电脑本地）
↓
git push 推到 GitHub（代码托管）
↓
Cloudflare Pages 监听到，自动构建
↓
全球 CDN 上线
↓
朋友访问 https://<你的项目>.pages.dev整个链路完全自动化——你写完 push，30 秒后博客就更新了。
二、技术选型对比
每一步都有几个选项可选，下面是我实测后的选择和理由。
1. 写作格式
| 选项 | 我选 | 为什么 |
|---|---|---|
| Markdown + 文本编辑器 | ✅ | 纯文本、可版本控制、AI 时代最适合 |
| Notion | ❌ | 数据锁死在平台、迁移困难 |
| 微信公众号编辑器 | ❌ | 阅读体验和可分享性都受限 |
| Word / Google Docs | ❌ | 不是博客的天然格式 |
2. 博客生成器（把 markdown 变成网页）
| 选项 | 我选 | 特点 |
|---|---|---|
| VitePress | ✅ | Vue 生态、笔记型最配、默认主题清爽 |
| Hexo | 主题多但配置碎 | |
| Hugo | 极快但 Go 模板陡 | |
| Astro | 现代但学习曲线 | |
| Next.js | 全功能但杀鸡用牛刀 | |
| Notion 公开页面 | 不需要工具但定制差 |
3. 代码托管
| 选项 | 我选 | 为什么 |
|---|---|---|
| GitHub | ✅ | Cloudflare Pages 唯一支持的主流之一 |
| Gitee | （备选） | 国内访问代码快，但不能直接部署 |
| 不用 git | ❌ | 失去版本管理 + 协作能力 |
4. 部署平台 ⭐ 最关键
| 选项 | 我选 | 国内访问 | 免费 | 备案 |
|---|---|---|---|---|
| Cloudflare Pages | ✅ | ✅ | ✅ | ❌ |
| Vercel | ❌ | 需 VPN | ✅ | ❌ |
| Netlify | ❌ | 较慢 | ✅ | ❌ |
| GitHub Pages | ❌ | 慢 | ✅ | ❌ |
| Gitee Pages Pro | ❌ | 最快 | ❌ 付费 | ✅ 需要 |
| 自建 VPS | ❌ | 看选址 | ❌ 月付 | 视情况 |
这是最不应该犹豫的一步——Cloudflare Pages 是个人博客的标准答案：国内访问 + 完全免费 + 自动构建 + 自动 HTTPS。
5. 评论系统（可选）
| 选项 | 我选 | 为什么 |
|---|---|---|
| Giscus（基于 GitHub Discussions） | ✅ | 数据归你自己、免费、不要后端 |
| Disqus | ❌ | 有广告、隐私差 |
| Waline | 需要 LeanCloud（要备案有限制） | |
| 自建 | ❌ | 要服务器要数据库 |
| 不要评论 | 也是个选项，省心 |
三、需要花多少时间
| 阶段 | 第一次（无经验） | 第二次（有 playbook） | 备注 |
|---|---|---|---|
| 内容写作 | 看你自己 | 同 | 不可压缩 |
| 注册 GitHub + 配 SSH | 30 分钟 | 1 分钟 | 一次性 |
| 装 VitePress + 配置 sidebar | 1 小时 | 10 分钟 | 拷模板就好 |
| 部署到 Cloudflare Pages | 5 分钟 | 5 分钟 | 网页操作不可省 |
| 加评论系统（可选） | 30 分钟 | 5 分钟 | |
| 调样式、修死链 | 30 分钟 | 0-5 分钟 | |
| 总计（不含写作） | ~3 小时 | ~20 分钟 |
结论：第一次花一个下午是值得的——把流程跑通后，第二次开新博客就 20 分钟。
四、需要花多少钱
| 项目 | 费用 | 说明 |
|---|---|---|
| GitHub | ¥0 | 个人公开仓库免费 |
| Cloudflare Pages | ¥0 | 个人项目免费 + 请求数无限 |
| Giscus 评论 | ¥0 | 完全免费 |
子域名 (.pages.dev) | ¥0 | Cloudflare 免费送 |
| 自定义域名（可选） | ~50 元/年 | Cloudflare Registrar 最便宜 |
| 自定义域名续费 | ~50 元/年 | |
| 基础博客总计 | ¥0 | 不要自定义域名 |
| 带域名总计 | ~50 元/年 | 想要 blog.你的名字.com |
💡 完全可以不花一分钱——直接用
<你的项目>.pages.dev这个域名就行。我血染钟楼博客就是这样，给朋友看完全够。
五、整个流程（高层步骤）
1. 写 3 篇 markdown 内容 （本地编辑器）
↓
2. 注册 GitHub 账号 （网页）
↓
3. 创建 GitHub 仓库 + 推送代码 （命令行）
↓
4. 装 VitePress + 配置 （命令行）
↓
5. 注册 Cloudflare 账号 （网页）
↓
6. 连接 GitHub 仓库 → 自动部署 （网页 5 分钟）
↓
7. 拿到 .pages.dev 链接 （网页）
↓
8. （可选）加评论系统 Giscus （网页 + 改一处代码）
↓
9. （可选）买自定义域名 （网页 + 50 元）每个步骤的详细教程在后续章节：
| 想知道 | 看哪 |
|---|---|
| 整体哲学和为什么这么选 | 01-overview.md |
| 怎么组织 markdown 内容 | 02-content.md |
| 怎么用 git + GitHub | 03-git-and-remote.md |
| VitePress 怎么配 | 04-vitepress.md |
| Cloudflare Pages 部署 | 05-deploy.md |
| 自动化工具链（高级） | 06-toolchain.md |
| 加评论系统等增强 | 07-enhancements.md |
六、几个常见疑问
Q: 我没编程基础，能搭吗？
能。整个流程涉及命令行的部分不超过 10 行命令，且 playbook 都给了原文。剩下都是网页点击。
但是：markdown 语法要学一下（30 分钟入门），不然写不了。
Q: 部署到 Cloudflare Pages 会被墙吗？
不会。Cloudflare Pages 在国内有节点（虽然不是最快，但稳定可访问），实测 99% 的国内运营商都能直接打开。
Q: 没有自定义域名（用 .pages.dev）能给别人看吗？
完全可以。.pages.dev 域名在国内就能访问，体验和自定义域名一样。唯一不同是 URL 长度——my-blog.pages.dev 比 my-blog.com 长一点，但功能上完全等价。
Q: 内容会被搜索引擎找到吗？
会，但需要主动让搜索引擎收录。VitePress 自带基本 SEO 配置，提交 sitemap 到 Google Search Console / 百度站长平台才能有搜索流量。如果你只想给朋友看不在意公域，不用管这个。
Q: 数据会丢吗？
博客内容：源代码在你的 GitHub 仓库 + 本地电脑——三处备份。 评论：如果用 Giscus，存在你的 GitHub Discussions——你拥有所有权。
不会丢。
Q: 我以后想换平台怎么办？
轻松迁移：
- 内容是 markdown，搬到任何平台都能用
- 域名指向新地方就行
- 评论数据可以从 GitHub Discussions 导出
这是这套架构的隐藏价值——没有任何供应商锁定。
Q: 国外朋友能看吗？
能。.pages.dev 全球 CDN，世界任何地方都能访问。
Q: 维护成本？
几乎为 0——所有平台都免费且不需要主动管理。 你只需要：
- 写新内容时
git push - 偶尔更新 VitePress 版本（一年一两次）
七、想自己搭一个？
按这两条建议：
第一次：跟着 playbook 完整走一遍
→ 读 01-overview.md 开始，按章节走完
不想看详细，照着抄就行
→ 看案例研究，那里有具体的执行时间线和命令
八、看完想找我聊？
文章下方有评论框（用你的 GitHub 账号登录就能留言），或者直接在 GitHub Discussions 提问。
我会持续更新这个 playbook——每次实践新主题都会回流补坑。