为什么我还是要写一个自己的博客
笔记散在五个 App 里之后,我决定退回到最原始的方式:Markdown 文件加 git。
平台换了又换,笔记散了又散。这次干脆自己搭一个,文章就是仓库里的 .md 文件。
笔记散在太多地方
翻了一下自己的记录,大致分布是这样的:
- 手机备忘录里有一堆“等有空整理”的草稿
- 语雀上有二十几篇写到一半的文档
- 某个笔记软件里存着截图,但软件已经停止更新了
- 还有一部分直接在聊天记录里,搜都搜不到
问题不在于哪个工具不好用,而在于这些内容没有一个是能直接拿走的。导出格式五花八门,图片还会挂。
所以这次的要求只有三条:文件在我手里、格式是纯文本、发布不用点一堆按钮。
为什么选静态站
博客本质上就是一堆不常变的页面。既然不常变,就没必要每次访问都让服务器现算一遍。
| 方案 | 成本 | 要维护什么 |
|---|---|---|
| 动态博客(数据库 + 后台) | 一台服务器 | 系统、数据库、备份、安全补丁 |
| 静态站 + CDN | 0 | 什么都不用管 |
静态站的代价是没有评论、没有在线编辑。但单人博客这两样本来也不是刚需,评论可以后面用 Giscus 补,写作我自己写 Markdown 就够了。
内容用 Content Collections
Astro 的 Content Collections 是我留下的主要原因。frontmatter 有类型校验,写错了构建就失败,而不是等页面渲染出来才发现日期是个字符串。
import { defineCollection, z } from 'astro:content';
import { glob } from 'astro/loaders';
const blog = defineCollection({
loader: glob({ pattern: '**/*.md', base: './src/content/blog' }),
schema: z.object({
title: z.string(),
pubDate: z.coerce.date(),
tags: z.array(z.string()).default([]),
draft: z.boolean().default(false),
}),
});
export const collections = { blog };
注意 z.coerce.date()。YAML 里的 2026-11-21 会被解析成 Date,但如果哪天手滑写成 2026/11/21,它会变成一个字符串,后面排序就乱了。coerce 会把它强行转过来,转不了就直接报错——这正是我想要的行为。
发布的流程
写完之后只需要两个动作:
git add src/content/blog/新文章.md
git commit -m "post: 新文章" && git push
推送后自动构建。整个流程里没有需要我记住的东西,这一点很重要——任何需要“记得去做”的步骤,最后都会忘。
一个刻意的取舍
文章页没有做目录侧边栏常驻。桌面端宽屏读者会用,但手机端它会挤掉正文。现在的做法是文章开头放一个折叠式的目录块,只在标题数 ≥ 2 时出现。
写博客这件事,我觉得最难的从来不是技术,是愿不愿意把没想清楚的东西也写下来。这篇就是。