Astro 7 静态站点搭配 Tailwind CSS 4,内容使用 Markdown / MDX 内容集合与 frontmatter 类型校验
Astro-Cactus — Astro 博客模板
作者 R007demo
Astro 7 + Tailwind 4 的浅色技术博客基线,含分类归档、Pagefind 搜索与自动 OG 图。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
固定浅色主题,深靛蓝、琥珀、珊瑚语义色体系,终端提示符 Logo 与配套 favicon、PWA 主题色、OG 图
文章、笔记、标签、分类四类归档,分类由 frontmatter 自动生成,无需单独建文件
Expressive Code 代码高亮(单一 GitHub Light 主题),长文正文加宽并保留桌面端目录
生产构建集成 Pagefind 全文搜索与标签过滤,并输出 RSS、sitemap、robots.txt、Web App Manifest 和自动 OG 图片
模板详细介绍
Astro-Cactus 是一个面向技术写作的 Astro 静态博客模板,v8.4.0 把它定位成「可以直接继续开发并发布」的基线,而不是一个需要大改的演示项目。它放弃了深色模式和主题切换器,固定浅色主题,用深靛蓝、琥珀与珊瑚三色搭出语义色体系,配合终端提示符风格的 Logo,整体气质偏工程笔记而非杂志式排版。文章列表按年份紧凑分组,长文页面保留桌面端目录,正文、引用、表格和代码块统一为浅灰背景加细边框,并允许横向滚动。
内容结构上,模板区分文章、笔记、标签和分类四类归档,分类不需要单独建文件,只要在 frontmatter 里写 `categories`,构建时就会生成 `/categories/` 和对应分类页;`tags` 与 `categories` 会自动去重并转小写。技术栈是 Astro 7 加 Tailwind CSS 4,内容用 Markdown / MDX 内容集合并带 frontmatter 类型校验,代码高亮走 Expressive Code 的单一 GitHub Light 主题。生产构建会生成 Pagefind 全文搜索索引,同时输出 RSS、sitemap、robots.txt、Web App Manifest 和自动 OG 图片,适合个人技术博客、团队工程笔记或文档型长文站点。
需要注意几处上线前的硬性检查:`src/site.config.ts` 里的 `url`、`title`、`author`、`description`、`lang` 和 `ogLocale` 都是占位值;`SocialList.astro` 中的 GitHub 地址和 `[email protected]` 邮箱必须替换;品牌图标和社交分享图也需按需覆盖。另外开发服务器不会加载 Pagefind 搜索 UI,验证搜索要走 `npm run build` 加 `npm run preview`。部署方面 README 明确站点始终使用根路由,GitHub Pages 需要用户根站点仓库或自定义域名。
适合你的项目吗?
适用场景
- 个人技术博客:需要长文排版、代码块、目录和分类归档,且不想自己搭搜索
- 团队工程笔记或内部知识库的静态前端,按分类和标签组织内容
- 以 Astro 为技术栈、希望从现成基线继续二次开发的项目
适合人群
- 接受固定浅色主题、不需要深色模式切换的站点
- 愿意在发布前替换站点配置、社交链接、图标和分享图的开发者
- 部署在根路由(用户根站点仓库或自定义域名)的场景
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
先执行 `npm install` 与 `npm run dev`,默认开发地址为 http://localhost:4321/
- 2
开发服务器不加载 Pagefind 搜索 UI,验证搜索需运行 `npm run build` 后再 `npm run preview`
- 3
替换 `src/site.config.ts` 中的 url、title、author、description、lang、ogLocale
- 4
检查 `src/components/SocialList.astro` 的 GitHub 地址与占位邮箱 [email protected]
- 5
按需替换 `public/icon.svg`(替换后需构建一次以重新生成 PWA 图标)与 `public/social-card.png`
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可,可免费使用、修改、分发与商用,仅需保留版权与许可声明。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明与许可声明
额外费用与待核对事项
- README仅含截图与许可标题,未说明图片素材授权
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
https://github.com/R007demo/Astro-Cactus/blob/main/LICENSEhttps://github.com/R007demo/Astro-Cactus/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料一般 · 62 / 100
- 技术栈
- Astro
- 网站类型
- 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-08-20
- 截图检查日期
- 2026-09-07
目前没有记录演示链接。请依据仓库说明在本地评估;仅凭截图无法确认交互行为。
目录记录的主要技术栈是 Astro。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

astrowind
⭕️ AstroWind: A free template using Astro v7 and Tailwind CSS v4. Astro starter theme.
Astro · 博客

astro-paper
A minimal, accessible and SEO-friendly Astro blog theme.
Astro · 博客

fuwari
✨A static blog template built with Astro.
Astro · 博客

Firefly
Firefly 是一款基于 Astro 的静态博客主题,由 CuteLeaf 在 saicaca 的 Fuwari 模板基础上二次开发,主打清新美观的视觉风格。
Astro · 博客

astro-theme-cactus
A simple Astro theme. Use it to create your blog or website.
Astro · 作品集

astrofy
Astrofy is a free and open-source template for your Personal Portfolio Website built with Astro and TailwindCS…
Astro · 作品集
