先准备两个账号#

需要 GitHub 和 Cloudflare。GitHub 存放网站程序和文章，Cloudflare Pages 负责构建、托管网站，并提供一个 pages.dev 地址。初步站点不需要先买域名，你也可以尝试用免费的二级域名免费域名和站长社区

默认路线是：

1
在 GitHub 创建自己的模板仓库
2
    ↓
3
Cloudflare Pages 连接这个仓库
4
    ↓
5
写 Markdown，提交到 main
6
    ↓
7
Cloudflare 自动构建并更新网站

这条路线不用 Cloudflare API Token。 写文章并不需要额外配置发布密钥；只有想改成 GitHub Actions 上传时，才需要后文的 Token

用模板创建自己的仓库#

模板仍然在这个地址，名字暂时没有改，旧链接也能继续用：

Sayori Lite 模板仓库

打开后点击 Use this template → Create a new repository，Owner 选择自己的账号，仓库名例如 my-blog

这次仓库已经包含完整的 Astro 网站，大致目录如下：

1
my-blog/
2
  articles/
3
    posts/
4
      hello-mizuki/
5
        index.md
6
        desk.svg
7
    spec/
8
      about.md
9
      friends.md
10
    templates/
11
      blog-post.md
12
  public/
13
    avatar.svg
14
    favicon.svg
15
  src/
16
  site.config.mjs
17
  package.json
18
  pnpm-lock.yaml
19
  .github/workflows/deploy-cloudflare-pages.yml

articles/ 是写作目录，src/ 是网站程序，文章直接参与构建

让 Cloudflare 连接 GitHub#

进入 Cloudflare 的 Workers & Pages，创建应用，选择 Pages，再选择导入现有 Git 仓库。授权 Cloudflare 访问自己刚创建的仓库，只授权这一个

构建设置填这些：

项目名会决定最初的 pages.dev 地址。保存并部署，等构建完成后打开 Cloudflare 显示的网址

Pages 会按锁文件安装依赖。如果环境没有正确提供 pnpm，模板 README 还给了包含固定版本 pnpm 安装步骤的备用构建命令，先看日志再改，不需要换一整个部署方案

SITE_URL 要填站点正式地址，因为 RSS、站点地图和 canonical 都会用它。以后绑定自己的域名，要把这里一起改掉再重新部署；不要填 GitHub 仓库地址或后台地址

改成自己的书桌#

在 GitHub 打开 site.config.mjs，点编辑，把站名、作者和简介换成自己的。头像文件放在 public/，配置里写对应的站内路径

1
export default {
2
  title: "我的书桌",
3
  author: "你的名字",
4
  description: "记录日常，也写一点认真整理过的东西",
5
  url: "",
6
  lang: "zh-CN",
7
  avatar: "/avatar.svg",
8
  note: "慢慢写，慢慢读",
9
};

已经设置了 Cloudflare 的 SITE_URL 时，配置里的 url 可以留空，环境变量优先

关于页改 articles/spec/about.md，友链页改 articles/spec/friends.md，友链直接写 Markdown 链接和介绍就好

模板有归档、文章目录、图片放大、深浅主题、Pagefind 搜索、RSS 和站点地图，正文使用系统字体

不装本地工具，也能发第一篇#

在 GitHub 仓库点 Add file → Create new file，文件名输入：

1
articles/posts/my-first-post/index.md

斜杠会帮你创建目录。正文可以先用下面这份：

1
---
2
title: 我的第一篇文章
3
description: 今天终于有了自己的博客
4
published: 2026-10-16
5
updated: 2026-10-16
6
draft: false
7
category: 日常
8
tags: [生活]
9
---
10

11
这里是第一段正文。不用重复写一级标题，页面会自动显示上面的 title
12

13
## 想记下的一件事
14

15
这里继续写

日期按自己实际写作的时间改。写完点 Commit changes，提交到 main。Cloudflare 检测到提交后会自动构建，成功后就能在首页看见文章

这里的规则很简单：每篇文章一个文件夹，名字用小写英文、数字和连字符，正文统一叫 index.md。my-first-post 决定公开地址 /posts/my-first-post/；以后改标题不会改地址，改文件夹名则会

draft: true 是草稿，只有改成 false 才会生成页面。发布日期在未来的文章也会暂时排除，到了日期还需要再触发一次构建，模板没有附带定时发布服务

private: true 在我自己的 Obsidian 发布流程里会跳过公开同步，让文章只保留在本地；这份独立模板目前只用 draft 控制页面发布

推荐用 Obsidian#

如果你平时就喜欢 Markdown，编辑器随便选，不过站长是用Obsidian来写的，所以对于Obsidian的适配工作流肯定会更好，想用 Obsidian 的话，可以这样做：

0. 下载obsidian
1. 安装 Git，把自己新建的仓库克隆到本地
2. 在 Obsidian 选择“打开文件夹作为仓库”，打开整个 my-blog 根目录，不要只打开 articles/
3. 模板已经准备好核心 Templates 设置，模板目录是 articles/templates
4. 在 articles/posts/文章名/ 创建 index.md，运行“插入模板”，选择 blog-post
5. 写好后改标题、日期和 draft，提交并推送到 GitHub

仓库根目录作为 Obsidian 仓库，是为了让 Git 插件直接找到同一层的 Git 仓库。附件默认放在当前文章旁边；文件叫 index.md 没关系，文章标题由属性里的 title 决定

想在 Obsidian 里提交，可以从社区插件市场安装作者为 Vinzent 的 Git 插件，插件 ID 是 obsidian-git

关于登录，我更建议复用系统 Git 的认证。Windows 安装 Git for Windows 时启用 Git Credential Manager，第一次在仓库目录执行 git push，按浏览器提示登录自己的 GitHub。完成后，桌面版 Obsidian Git 就可以使用系统 Git 已有的凭据

想在本地看效果#

网页编辑可以先用起来。需要实时预览时，再安装 Node.js 22.12 以上版本，然后在自己的仓库根目录运行：

1
npm install --global [email protected]
2
pnpm install --frozen-lockfile
3
pnpm dev

打开终端显示的地址，默认是 http://localhost:4321。改 Markdown 后会自动刷新

搜索索引在构建时生成，想检查搜索就运行：

1
pnpm run build
2
pnpm preview

这次打开预览命令显示的地址。普通写作时不用每改一段就完整构建一次

可选：用 Token 交给 GitHub Actions 发布#

如果你希望在 GitHub 的检查全部通过后才上传网站，可以选择这条路线。默认 Git 集成已经够用，不需要为了写文章再配一次

先准备一个已经存在的 Pages 项目。原来连接 GitHub 的项目，要在 Cloudflare 的 Build 和 Branch control 中关闭生产、预览分支自动部署，避免同一次提交发布两遍

创建 Cloudflare 自定义 API Token，权限只选目标账户的 Account → Cloudflare Pages → Edit

然后进入 GitHub 仓库的 Settings → Secrets and variables → Actions，填写：

模板里的 .github/workflows/deploy-cloudflare-pages.yml 默认只检查。只有设置了 CF_PAGES_DEPLOY，才会把通过检查的同一份构建产物上传到指定项目

以后仍然是在文章文件夹里写 Markdown、提交到 main，区别只是最后由 Actions 上传。Token 放在 GitHub Secrets

以后想改哪里#

这份模板默认是一个简中文章站，不要求每篇文章同时提供三种语言。它和我自己博客的三语发布系统是独立的，先把写作和发布做简单。以后有明确需要，再一点点加上评论或其他功能就好

我还是觉得，博客最重要的里面的内容，所以现在的我就选择了这个简洁的模板，写出更多更好的内容

继续读#

站点上线后，先配一个 免费域名；想了解 DNS、图片存储和服务入口，接着看 Cloudflare 免费层；想在手机和电脑间同步写作，看看 Fast Note Sync

这套简洁风格的取舍放在 博客改版记录，站点上线后想检查抓取和页面信息，可以接着看 GeoScore 网站体检