📖 什么是碎碎念#

和文章相对的轻量内容：几句话、随手拍、临时想法。它和文章共用一套发布流程（写文件 → git push），只是文件放不同目录、frontmatter 更简单。

一、文件放在哪、怎么命名#

1
src/content/dynamic/2026-09-07-123000.md

• 目录固定：src/content/dynamic/
• 文件名 = 发布时间 YYYY-MM-DD-HHMMSS.md（命名规则即排序规则，别乱起名）
• 每一条碎碎念 = 一个文件

仓库里留了一条参考文件，忘了怎么写就打开看：src/content/dynamic/ 下最早那条。

二、frontmatter（只有 3 个字段）#

1
---
2
published: 2026-09-07 12:30:00    # 必填，发布时间
3
pinned: true                        # 可选，true 则置顶
4
location: 中国                      # 可选，显示地点
5
---
6

7
正文内容随便写……支持普通 Markdown。

三、发布：脚手架一行命令（最快）#

1
pnpm new-dynamic 今天的第一条碎碎念！

它自动做三件事：

1. 用当前时间生成合法文件名
2. 写进 src/content/dynamic/
3. 自动填好 published 字段

一句话就一条，不需要手动想文件名和日期。

1
pnpm new-dynamic 带地点的碎碎念
2
# 然后打开生成的文件，在 --- 之间补上
3
# location: 中国

四、图片怎么放#

用标准 Markdown，多张图片会自动拼成图集：

1
正文……
2

3
![第一张](https://cdn.xxx.top/dynamic/2026-09-07-a.webp)
4
![第二张](https://cdn.xxx.top/dynamic/2026-09-07-b.webp)

• 图片本体先传图床（见 R2 图床运营规范），再贴链接
• 图片放正文任意位置即可，位置决定显示顺序

五、修改与删除#

• 改：直接编辑那个 .md 文件（改正文、补 location…）→ git 三步 → 覆盖更新
• 置顶/取消置顶：加/删 pinned: true
• 删除：删文件 → git 三步 → 线上消失。删除不可恢复，删前确认

发布/修改/删除都是那三连：

1
git add .
2
git commit -m "新增一条碎碎念"   # 或 修改 / 删除
3
git push

✅ 碎碎念速记#

1. 随手短记录 → src/content/dynamic/
2. 最快发布：pnpm new-dynamic 内容
3. frontmatter 就 published（+ 可选 pinned/location）
4. 图片：传图床 → ![](链接)，多张自动成图集
5. 上线方式与文章完全一样：git 三连