编辑与发布
所有页面都是 content/ 目录下的 Markdown 文件。改完推送到 GitHub,Cloudflare Pages 会自动重新构建,通常一分钟内生效。
方式一:Obsidian(推荐日常写作)
- 用 Obsidian 打开仓库里的
content/文件夹作为 vault。 - 安装并启用
obsidian-git插件,设置自动 commit / push。 - 新建笔记时保留 frontmatter:
---
title: 页面标题
description: 一句话摘要
tags:
- 工程
---文件名就是链接名
[[编辑与发布]]指向编辑与发布.md。重命名时 Obsidian 会自动更新所有双链。
方式二:浏览器
- 在 GitHub 仓库页按
.打开 github.dev,直接编辑并提交。 - 非技术同事可以用 Pages CMS 打开同一个仓库,表单化编辑,支持上传附件和图片。
方式三:AI
仓库根目录的 AGENTS.md 写了内容规范。让 Claude Code、Codex 或 repowiki-cli 按规范新增或修改页面,提交 PR 后先在预览环境确认,再合并。
发布流程
- 修改
content/ - commit + push 到
main - 等待自动构建
- 打开站点确认
草稿不是权限
frontmatter 写
draft: true的页面不会进入构建结果,但它只是“不发布”,不是访问控制。真正的私有靠 权限与访问 里的 Cloudflare Access。