项目介绍
将博客源码放在 GitHub,再由 Cloudflare 构建发布,适合内容主要由 Markdown 管理的静态站点。构建产物目录与框架有关,静态输出和服务端渲染应分开选择。
整个流程由三部分组成:GitHub 保存模板与文章,站点框架把 Markdown 转成网页,Cloudflare 接收构建产物并提供访问入口。后续改标题、换主题和写文章,都通过同一仓库管理,能够追踪每次修改。
适合个人博客、学习记录与以阅读为主的项目文档。需要网页后台多人编辑、复杂会员权限或实时数据库时,应先比较动态建站方案;静态模板中的评论和搜索也可能依赖额外服务。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 版本管理 | 文章与配置一起提交,出现问题可查看差异和恢复旧版本。 |
| 自动构建 | 向部署分支推送后触发构建,日志可用于定位依赖和路径问题。 |
| 预览访问 | 先在平台域名检查页面,再接入自己的域名。 |
| Markdown 写作 | 通过模板支持的元数据管理标题、日期、分类和封面。 |
| 静态资源分发 | HTML、样式和图片作为构建产物发布,适合阅读型站点。 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 配置指南 |
| 分类 | 建站与协作 |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
安装或使用条件
先确认所用项目版本、操作系统与依赖,准备独立测试目录及可恢复的数据副本。本文中的操作流程需与对应版本的官方说明配合使用。
安装与使用步骤
- 选择维护活跃、许可清楚的博客模板,Fork 后先按 README 在本地安装依赖并预览。
- 在 Cloudflare 创建 Git 集成项目,选择正确分支,按框架文档设置构建命令和产物目录。
- 先用平台预览域名检查文章、图片、站内链接和移动布局,再绑定自己的域名。
- 提交一篇测试文章,确认 Git 推送可以触发构建,失败时查看构建日志。
首次使用与操作检查
先复制模板中已有的一篇文章,保留字段结构,只替换标题、正文与图片路径。在本地确认列表页、正文页和图片都正常,再提交到自己的分支。
构建失败先看报错发生在安装、编译还是上传阶段。线上有首页却打不开文章时,核对基础路径、链接大小写和构建输出;内容更新后还显示旧页面,再检查部署分支与缓存。
配置与常见问题
- 免费套餐存在请求、构建和存储限制,以账号当前规则为准。
- 模板含 SSR 或动态接口时,要按 Workers/适配器文档配置,不能照搬纯静态输出目录。
更新与备份
Git 仓库保存内容与主题,同时记录 Cloudflare 构建设置和域名解析。