Astro博客

minimal — Astro 博客模板

作者 ekmas

Minimal 是一个基于 Astro 的极简博客主题，使用 Tailwind 进行样式设计，支持深色/浅色模式、MD 与 MDX 文章、内容集合以及 View Transitions API。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

3 个预览视图

桌面端首页1 / 3

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

桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

基于 Astro 构建的博客主题，使用 Tailwind 进行样式设计

支持深色与浅色模式切换

支持 Markdown 与 MDX 文章，并通过内容集合管理

使用 Expressive Code 与 Shiki 处理代码块语法高亮

集成 View Transitions API 处理页面过渡

采用 MIT 许可，可免费使用、修改、商用和分发

模板详细介绍

Minimal 是一个面向博客场景的 Astro 主题，仓库由 ekmas 维护，采用 MIT 许可。主题以极简为设计方向，使用 Tailwind 处理样式，并内置深色/浅色模式切换。内容层面支持 Markdown 与 MDX 文章，通过 Astro 内容集合管理文章，文章需放在 src/content/posts 目录下，并在 frontmatter 中提供 title、description、pubDate 和 tags 字段。代码块使用 Expressive Code 与 Shiki 进行语法高亮，可通过 astro.config.mjs 中的 expressiveCode 对象调整配置，切换代码块主题时需要同时更新 themes 数组和 config.ts。主题还使用 View Transitions API 处理页面过渡，图标来自 Svgrepo。

使用前需要在 astro.config.mjs 中修改 site 字段，并在 src/config.ts 中配置 meta 标签所需数据；整体布局颜色可在 Tailwind 配置中调整。项目提供 npm install、npm run dev、npm run build、npm run preview 等命令，开发服务器默认运行在 localhost:4321。README 未说明文章分页、评论、搜索、RSS 或国际化等功能，也未提供部署以外的生产环境细节。演示站点为 astro-minimal.netlify.app。

Astro博客

适合你的项目吗？

适用场景

搭建以文章列表和文章详情为核心的极简个人博客
需要一个支持 MD 与 MDX 混合写作的 Astro 博客起始模板
希望使用 Tailwind 快速调整整体配色和布局的博客项目
需要深色/浅色模式与代码高亮的开发者博客

适合人群

熟悉 Astro 与 Markdown 写作的开发者
偏好极简排版、不需要复杂后台的博客作者
希望以 MIT 许可代码为基础进行二次修改的项目

上手与定制指南

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

1
通过 GitHub 模板生成新仓库，或克隆仓库后运行 npm install 安装依赖
2
在 astro.config.mjs 中修改 site 字段，并在 src/config.ts 中配置 meta 标签数据
3
新增文章时在 src/content/posts 下创建 md/mdx 文件，frontmatter 需包含 title、description、pubDate 和 tags
4
切换代码块主题时需同时更新 astro.config.mjs 的 themes 数组与 config.ts
5
演示图片、字体、图标等第三方素材需按各自许可单独核对

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

主题使用的图标来自第三方站点 Svgrepo，其图标素材可能适用各自的许可条款，与项目本身的 MIT 代码许可相互独立，商用或再分发前需自行核实图标素材的授权情况。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

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

Icons by [Svgrepo](https://www.svgrepo.com/)
README 原文

https://github.com/ekmas/minimal/blob/main/LICENSE https://github.com/ekmas/minimal/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

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

这个分数如何计算

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

这个项目需要核对什么

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

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: 960e994d22b7d311e09f3e1320a6769da2d17a9cea918821fada6c41b41777e2

2026-10-01T13:30:21.737Z

来源文件 / 仓库

# Minimal

Minimal is a minimalistic astro theme for blogs.

## Get started

[Create a new repo](https://github.com/ekmas/minimal/generate) from this template.

## Features

- Astro v4
- Tailwind for styling
- Responsive & SEO-friendly
- Dark/Light mode support
- MD & MDX posts
- View Transitions API
- Content collections
- Expressive-code code blocks
- Shiki code syntax styling
- Icons by [Svgrepo](https://www.svgrepo.com/)

## Configure

- Go to `astro.config.mjs` and change site
- Go to `src/config.ts` and configure data for meta tags
- You can also customize colors of entire layout by changing colors in tailwind config.
- You can customize code blocks config by changing `expressiveCode` object in astro config. Visit [expressive-code docs](https://expressive-code.com/reference/configuration) for more info.
- To change code blocks theme, you'll have to update themes both in `themes` array and in `config.ts`

## How to add new post

Create a new md/mdx file inside src/content/posts, and make sure it's in this format:

```
---
title: 'First post'
description: 'Lorem ipsum dolor sit amet'
pubDate: 'Dec 22 2023'
tags: ['astro', 'blogging', 'learning']
---

Your post
```

## Commands

All commands are run from the root of the project, from a terminal:

| Command                   | Action                                           |
| :------------------------ | :----------------------------------------------- |
| `npm install`             | Installs dependencies                            |
| `npm run dev`             | Starts local dev server at `localhost:4321`      |
| `npm run build`           | Build your production site to `./dist/`          |
| `npm run preview`         | Preview your build locally, before deploying     |
| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
| `npm run astro -- --help` | Get help using the Astro CLI                     |

## License

MIT

反馈内容错误