Astro博客

astro-air — Astro 博客模板

作者 sun0225SUN

Astro Air 是一个基于 Astro 的极简个人博客主题，支持深色模式、响应式布局、Markdown/MDX 写作与中英双语。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

3 个预览视图

桌面端首页1 / 3

访问演示网站在新标签页打开

桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 3

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-09-30查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

基于 Astro 的极简个人博客主题，内容使用 Markdown/MDX 编写

支持深色模式与响应式布局，适配桌面端和移动端

内置中英双语（i18n），并提供 RSS 订阅与 sitemap

集成 Twikoo 评论与 Google Analytics，可配置社交链接

站点配置、链接与关于/简介/友链页面内容分文件管理，便于替换

README 提供 Vercel、Netlify 部署入口与同步上游更新的 git 步骤

模板详细介绍

Astro Air 是作者 sun0225SUN 发布的个人博客主题，使用 Astro 构建，定位为极简风格。内容以 Markdown/MDX 撰写，文章放在 src/content/posts/ 目录，通过 frontmatter 定义标题、描述、发布日期、可选更新日期、标签与封面图。站点配置集中在 src/config/index.ts 与 src/config/links.ts，关于页、简介页和友链页内容分别由 src/config/zh(en)/ 下的 about.mdx、intro.mdx、links.mdx 提供。主题内置深色模式、响应式布局、中英双语（i18n）、RSS 与 sitemap、社交链接、Google Analytics 以及基于 Twikoo 的评论集成，并带有过渡与动画效果。README 中本地搜索仍标记为未完成，因此该功能不应视为已具备。项目采用 SSG 静态渲染，README 提供 Vercel 与 Netlify 的部署按钮，并给出通过 git remote 添加 upstream 后 fetch、merge 来同步主题更新的步骤。代码以 MIT 许可发布，可免费使用、修改、商用和分发，但演示图片、字体、图标等第三方素材需单独核对许可，域名、托管等外部服务可能另行收费。

Astro博客

适合你的项目吗？

适用场景

搭建个人技术博客或写作站点
需要中英双语与 RSS 输出的内容站点
希望用 Markdown/MDX 管理文章并静态部署的博客
想以现成主题快速起步、再按需调整配置的个人项目

适合人群

使用 Astro 并偏好极简排版的个人博主
以 Markdown/MDX 写作、接受静态生成流程的作者
需要中英双语、RSS 与评论功能的独立博客
计划部署到 Vercel 或 Netlify 等静态托管平台的用户

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
克隆仓库后进入目录，使用 pnpm install 安装依赖，pnpm dev 启动本地开发
2
在 src/config/index.ts 修改站点设置，在 src/config/links.ts 修改站点链接
3
在 src/config/zh(en)/ 下编辑 about.mdx、intro.mdx、links.mdx 定制对应页面内容
4
新文章放入 src/content/posts/，按 README 给出的 frontmatter 字段填写标题、描述、日期、标签与封面图
5
同步主题更新可添加 upstream 远程仓库后执行 git fetch upstream 与 git merge upstream/main --allow-unrelated-histories

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

评论功能依赖第三方 Twikoo 服务，需自行部署或配置 Twikoo 后端，可能产生额外服务与费用。
Google Analytics 集成需自行申请 Google Analytics 账号并配置跟踪 ID，属外部服务。
部署到 Vercel 需注册 Vercel 账号，托管服务可能按用量收费。
部署到 Netlify 需注册 Netlify 账号，托管服务可能按用量收费。
本地搜索功能在 README 中标记为未完成，不应视为已具备。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

Commenting Integration (Twikoo)
README 原文

Google analysis integration
README 原文

Deploy with Vercel
README 原文

Deploy to Netlify
README 原文

Local search functionality
README 原文

https://github.com/sun0225SUN/astro-air/blob/main/LICENSE https://github.com/sun0225SUN/astro-air/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-09-30。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料较完整 · 87 / 100
技术栈: Astro
网站类型: 博客

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2025-10-27
截图检查日期: 2026-09-30

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Astro。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: 45916c685114850cb59ee571c9d464a6443e7eda5db0ada09145c40927a48025

2026-09-30T08:54:30.226Z

来源文件 / 仓库

# Astro Air

A minimalism, personal blog theme for Astro.

> If you find this project helpful, please consider giving it a star ⭐️

[![Built with Astro](https://astro.badg.es/v1/built-with-astro/tiny.svg)](https://astro.build) [![Netlify Status](https://api.netlify.com/api/v1/badges/3e2c71b9-071f-4846-9321-41c949134ebf/deploy-status)](https://app.netlify.com/sites/astro-air/deploys)

<img style="border-radius: 10px;" src="https://cdn.jsdelivr.net/gh/sun0225SUN/astro-air/public/preview.png" alt="Astro Air">

## Showcase

- [Astro Air](https://astro-air.guoqi.dev)
- [Guoqi's blog](https://blog.sunguoqi.com)
- ...

> welcome to add your own blog to the list ❤️

## Features

- [x] 🌓 Dark mode support
- [x] 📱 Fully device responsive
- [x] 🎨 Clean and minimalist design
- [x] 📝 Markdown/MDX for content authoring
- [x] 🏄‍♂️ SSG static rendering, SEO friendly
- [x] 🌐 i18n support (EN/ZH)
- [x] 🔗 Social media integration
- [x] 📰 RSS feed & sitemap support
- [x] 🛠️ Google analysis integration
- [x] 💬 Commenting Integration (Twikoo)
- [x] 🎨 Enhance Transition and Animation
- [ ] 🔍 Local search functionality
- [ ] ...and more

## Quick Start

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/sun0225SUN/astro-air)

[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/sun0225SUN/astro-air)

## Configuration

- Open `src/config/index.ts` and customize your site settings

- Open `src/config/links.ts` and customize your site links

- Open `src/config/zh(en)/about.mdx(intro.mdx、links.mdx)` and customize your pages content

## Writing Content

1. Create new blog posts in the `src/content/posts/` directory
2. Use the following frontmatter template:

```markdown
---
title: "Your Post Title"
description: "A brief description of your post"
pubDate: YYYY-MM-DD
updatedDate(optional): YYYY-MM-DD
tags(optional): ["tag1", "tag2"]
ogImage(optional): "cover image URL"
---

Your content here...
```

## Update Theme

```bash
git remote add upstream https://github.com/sun0225SUN/astro-air

git fetch upstream

git merge upstream/main --allow-unrelated-histories

```

## Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create your feature branch
3. Submit a pull request

```bash
git clone https://github.com/sun0225SUN/astro-air

cd astro-air

pnpm install

pnpm dev
```

## License

This project is licensed under the MIT License - see the LICENSE file for details.

反馈内容错误