内容发布全流程（写文章 + 推送上线）

📖 一句话理解本站内容#

本站是静态站：文字（Markdown）存在 Git 仓库里，图片存在对象存储里，两者分开。你只要做一件事——改好文字 → git push，剩下的构建、上线全部自动完成。

1
你在 Obsidian / 编辑器里写 .md
2
        │
3
   图片先传图床 → 得到 https://cdn.xxx.top/xxx.webp
4
        │
5
   正文里用 ![](图片链接) 引用
6
        │
7
   git add → commit → push（GitHub）
8
        │
9
   云端自动构建 → 站点更新

仓库的位置、图床的上传工具、每次构建后去哪个平台确认，见本系列「R2 图床运营规范」。本文只讲「内容怎么发布」。

一、内容文件都放在哪#

1
src/content/
2
├── posts/      ← 博客文章（长篇，本文的主角）
3
│   ├── xxx.md
4
│   └── 子目录/  ← 也可以建子目录归类，不影响发布
5
├── dynamic/    ← 碎碎念（短记录，单独一篇讲）
6
└── spec/       ← 固定页面（关于/留言板/协议）

判断标准：想认真写的长篇 → posts；随手一句话/一张图 → dynamic；站点固定文案 → spec。

二、新建一篇文章#

方式 A：脚手架命令（推荐）#

1
pnpm new-post my-first-post

会在 src/content/posts/my-first-post.md 生成带完整 frontmatter 模板的文件，你只需填内容。

方式 B：手动新建#

在 src/content/posts/ 里新建 .md 文件，最少只需 3 个字段：

1
---
2
title: 我的第一篇文章      # 网页显示的大标题
3
published: 2026-09-07      # 发布日期，决定出现在哪一天
4
category: 闲谈杂录           # 分类（留空也可以）
5
---
6
正文……支持完整 Markdown。

常用可选字段#

字段	作用	什么时候用
`description`	摘要，显示在列表卡片上	想让首页简介好看点就填
`tags`	标签数组 `[A, B]`	按主题聚合同类文章
`image`	封面图	网络链接或相对路径
`pinned`	`true` = 置顶到列表顶部	公告类、长期有效文章
`draft`	`true` = 草稿，不上线	没写完不想发布
`updated`	修订日期	大改后补一笔
`password` / `passwordHint`	加密整篇正文	私密文章（见系列「文章加密」篇）
`series` / `seriesOrder`	归入系列	见下文

⚠️ cover 图片规范：封面、正文图片一律传图床后填 https://… 完整链接，不要往仓库里塞图片文件（会让仓库变大、构建变慢）。传图细节见 R2 图床运营规范。

三、系列字段（series / seriesOrder）#

「系列」就是把几篇文章串成一个合集，在 /series/ 页面统一展示、自动生成上一篇/下一篇导航。

1
---
2
title: 某一篇
3
series: "Firefly 教程"     # 填同一个系列名 → 自动归到一起
4
seriesOrder: 5             # 该系列内的排序，数字小的在前
5
---

归到哪个系列，取决于 series 填的名字，跟文件在哪个目录无关
不填 series = 独立文章，不进任何系列
seriesOrder 只影响系列内顺序，不影响主页按日期的排序

本站约定：以后所有本站维护教程都放进 Firefly 教程 系列，新文章记得 seriesOrder 接续现有最大号。

四、发布：git 三步#

写完、本地预览没问题后，在仓库根目录执行：

1
git add .
2
git commit -m "新增：xxx 文章"
3
git push

三步各管一件事：

命令	作用
`git add .`	把改动「登记」进暂存区
`git commit`	打一个本地存档点
`git push`	把存档传到 GitHub —— 只有这一步才会触发线上构建

commit 消息建议用 新增：… / 修改：… / 删除：… 开头，方便以后翻历史。

push 成功后，GitHub 会自动触发构建，多个部署平台陆续更新。构建需要一两分钟，别急着刷新。

本地预览（发布前检查）#

1
pnpm dev        # 打开 http://localhost:4321 预览
2
pnpm build      # 生产构建，发布前跑一遍确保没报错

pnpm 全部指令、构建流水线原理、常见坑，见本系列「pnpm 常用指令速查」。

五、修改与删除文章#

改文字：直接改 .md → git 三步 → 覆盖更新
改网址：文章网址 = 文件相对路径去掉扩展名（my-first-post.md → /posts/my-first-post/）。改名 = 改网址，会让旧链接 404、影响已分享出去的地址——发布过的文章尽量别改名
下线文章：最稳妥是 draft: true（保留草稿可再启用）；真要删就删文件，但注意删了无法找回

六、Obsidian 写作小贴士（个人习惯）#

Markdown 语法与系列里的《Markdown 教程》一致，Obsidian 所见即所得
传图用图床工具，自动返回 ![](链接) 格式直接粘贴
写「本站维护教程」时，正文开头能配一张封面/示意图观感更好

✅ 发布清单（自检）#

图片已传图床、正文里是 https://… 链接（不是本地路径）
frontmatter 完整，published 是 YYYY-MM-DD
pnpm dev 本地能正常渲染
git add → commit → push 三连，push 输出无报错
一分钟后线上刷新能看到

音乐

Hecloud

音乐