配置驱动:只需编辑config、content和public/images,无需修改源码
astro_blog_template — Astro 作品集模板
作者 noir1458
配置优先的Astro博客与作品集模板,支持Markdown、搜索、SEO、暗色模式,可直接部署到GitHub Pages。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。 本截图因高度限制未包含整页。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
内置Markdown文章与项目展示,支持分类、标签、草稿、数学公式、Mermaid图表
集成Pagefind搜索、RSS、站点地图、SEO元数据(Open Graph、JSON-LD)
暗色模式与可调强调色,支持全站背景横幅
GitHub Actions自动验证与部署,支持自定义域名
可选Giscus评论和公共分析集成
模板详细介绍
这是一个以配置为先的Astro博客与作品集模板,设计初衷是让用户只编辑config/、content/和public/images/三个目录即可完成站点定制,无需改动Astro或TypeScript源码。模板内置了Markdown文章与项目展示、Pagefind搜索、RSS、站点地图、SEO元数据、暗色模式以及示例内容,并附带GitHub Actions工作流,可自动验证并部署到GitHub Pages。演示站点和起始模板都展示了全站背景横幅效果,用户可替换图片或通过一个设置关闭。
内容组织上,文章存放在content/posts/分组/分类/别名/index.md,支持草稿、数学公式、提示框、Mermaid图表和代码高亮;项目页支持独立封面图、仓库链接和演示链接。站点配置集中在多个YAML文件中,例如site.yaml管理站点身份与外观(包括强调色色相和横幅),navigation.yaml管理导航,categories.yaml控制侧边栏分组,features.yaml可开关搜索、评论、项目等模块。模板还提供多语言路由支持,并可通过npm run new快速创建草稿。
适合希望快速搭建个人博客或作品集、并偏好GitHub Pages托管的开发者。需要注意的是,模板要求Node.js 24或更高版本,本地开发需安装Playwright的Chromium。上线前应仔细核对site.url是否为最终公开地址,并确保所有配置的图片路径真实存在,否则构建会失败。评论功能(Giscus)和分析集成需要自行提供公开的配置标识,若未配置应关闭相应功能。
适合你的项目吗?
适用场景
- 个人技术博客或写作站点
- 开发者作品集展示
- 项目文档或知识库
- 快速搭建静态内容网站
适合人群
- 熟悉GitHub Pages和基本Git操作的开发者
- 希望用Markdown写作并自动部署的用户
- 需要多语言内容或SEO优化的站点
- 偏好配置驱动、低代码定制的用户
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
使用前需准备Node.js 24+和npm,并安装Playwright Chromium。
- 2
部署前在GitHub仓库Settings→Pages中将Source设为GitHub Actions。
- 3
务必修改config/site.yaml中的site.url为最终公开地址,并替换所有示例图片和内容。
- 4
运行npm run check验证配置无误。
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可证允许免费使用、修改、分发和商用,仅需保留版权与许可声明;README未附加额外授权限制。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 在所有副本或实质性部分中保留版权声明和许可声明
额外费用与待核对事项
- README未说明示例图片、字体等第三方素材的授权情况
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
The above copyright notice and this permission notice shall be included in all
许可证原文
This template is available under the [MIT License](./LICENSE).
README 原文
https://github.com/noir1458/astro_blog_template/blob/main/LICENSEhttps://github.com/noir1458/astro_blog_template/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 79 / 100
- 技术栈
- Astro
- 网站类型
- 作品集 · 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-09-04
- 截图检查日期
- 2026-09-06
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 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 · 作品集
