编辑与发布

所有页面都是 content/ 目录下的 Markdown 文件。改完推送到 GitHub,Cloudflare Pages 会自动重新构建,通常一分钟内生效。

方式一:Obsidian(推荐日常写作)

  1. 用 Obsidian 打开仓库里的 content/ 文件夹作为 vault。
  2. 安装并启用 obsidian-git 插件,设置自动 commit / push。
  3. 新建笔记时保留 frontmatter:
---
title: 页面标题
description: 一句话摘要
tags:
  - 工程
---

文件名就是链接名

[[编辑与发布]] 指向 编辑与发布.md。重命名时 Obsidian 会自动更新所有双链。

方式二:浏览器

  • 在 GitHub 仓库页按 . 打开 github.dev,直接编辑并提交。
  • 非技术同事可以用 Pages CMS 打开同一个仓库,表单化编辑,支持上传附件和图片。

方式三:AI

仓库根目录的 AGENTS.md 写了内容规范。让 Claude Code、Codex 或 repowiki-cli 按规范新增或修改页面,提交 PR 后先在预览环境确认,再合并。

发布流程

  1. 修改 content/
  2. commit + push 到 main
  3. 等待自动构建
  4. 打开站点确认

草稿不是权限

frontmatter 写 draft: true 的页面不会进入构建结果,但它只是“不发布”,不是访问控制。真正的私有靠 权限与访问 里的 Cloudflare Access。