Article / 2026/05/28

Astro 技术博客启动笔记

用 Astro、Markdown、RSS、Pagefind 和 Giscus 搭建一个可部署的极简技术博客。

为什么选 Astro

Astro 很适合技术博客:默认输出静态 HTML,内容可以直接写 Markdown,首屏速度快,部署到 Cloudflare Pages 也很自然。

已经内置的能力

  • Markdown 文件自动生成文章页面
  • 文章页自动目录
  • 标签页和标签归档
  • RSS、sitemap、robots.txt
  • Pagefind 静态搜索
  • Giscus 评论占位
  • GitHub Actions 部署到 Cloudflare Pages

写新文章

src/content/blog 下新建一个 .md 文件,补齐 frontmatter 即可:

---
title: 文章标题
description: 一句话摘要
pubDate: 2026-05-28
tags: [Astro, Notes]
draft: false
---

下一步

src/site.config.ts 里的站点地址、作者、Giscus 仓库信息替换成你自己的配置,然后推送到 GitHub。

Giscus 未启用:请在 src/site.config.ts 中配置 repoId 与 categoryId。