把博客从零搭了一遍

旧博客挂在某平台上,导出一次要点七下鼠标,我一直没敢动。上周终于受不了,花了两个晚上重写。

现在的结构很简单:

src/content/posts/
├─ 2026-08-15-rebuild-blog.md
├─ 2026-07-30-reading.md
└─ ...

一篇文章就是一个 .md 文件,头部写清楚元信息:

---
title: 把博客从零搭了一遍
date: 2026-08-15
updated: 2026-08-20
tags: [技术, 折腾]
---

正文用 Markdown 写,构建的时候转成静态 HTML。

为什么选 Astro

三点:

  1. 默认不输出任何 JavaScript,页面轻
  2. Markdown 和内容集合是一等公民,标签、归档这类路由是自动生成
  3. 部署就是一堆静态文件,托管在哪儿都行

唯一踩的坑

代码高亮想跟着系统深色模式切换,得配双主题,只写一个 theme 的话,深色模式下代码块会亮得像块补丁:

markdown: {
  shikiConfig: {
    themes: { light: 'github-light', dark: 'github-dark' },
    defaultColor: false,
  },
}

然后在 CSS 里用 prefers-color-scheme 把两套变量分别接上。

写完这篇之后,我把旧站的文章全部迁过来了。一共 41 篇,比我以为的少,也比我以为的重。

修改于 2026 年 8 月 20 日

留言