为什么我还是要写一个自己的博客

笔记散在五个 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 时出现。

写博客这件事,我觉得最难的从来不是技术,是愿不愿意把没想清楚的东西也写下来。这篇就是。

← 返回文章列表