Repolode
satnaing

satnaing/astro-paper

基于 Astro 构建的极简、无障碍且利于 SEO 的博客主题,内置静态搜索。

可替代:MediumGhost

Star
5,137
Fork
1,118
未关闭 Issue
32
最近提交
21小时前

这是什么?

AstroPaper 是一款面向 Astro 静态站点生成器的博客主题。它提供现成的页面布局,支持用 Markdown 或 MDX 撰写文章,内容具备类型安全,并包含草稿、分页、可折叠目录以及亮色与暗色模式。

主题自带 sitemap 和 RSS 订阅,附带 SEO 元信息,并能为每篇文章动态生成 Open Graph 图片。搜索功能通过 Pagefind 静态实现,无需后端或外部搜索服务。样式基于 Tailwind CSS,项目使用 TypeScript 编写。

站点配置集中在 astro-paper.config.ts 中,颜色方案和站点信息都可以自定义。构建产物为静态文件,可部署到 Cloudflare Pages 等静态托管平台。

核心功能

  • 01支持 Markdown 与 MDX,内容类型安全
  • 02基于 Pagefind 的静态搜索
  • 03亮色与暗色模式,并提供预设配色方案
  • 04自带 sitemap、RSS 订阅和 SEO 元信息
  • 05为文章动态生成 Open Graph 图片
  • 06兼顾键盘操作与屏幕阅读器的无障碍设计

适用场景

  • 在静态托管平台上搭建个人或技术博客
  • 发布带草稿与分页功能的写作站点
  • 需要无后端搜索的 Markdown 博客

快速上手

  1. 1

    使用 pnpm 从模板创建新项目

    pnpm create astro@latest --template satnaing/astro-paper
  2. 2

    安装依赖

    pnpm install
  3. 3

    启动本地开发服务器

    pnpm dev

使用前须知

  • 基于 Astro 构建,需要在本地安装 Node.js 和 pnpm。

标签

常见问题

astro-paper 是什么?
基于 Astro 构建的极简、无障碍且利于 SEO 的博客主题,内置静态搜索。 AstroPaper 是一款面向 Astro 静态站点生成器的博客主题。它提供现成的页面布局,支持用 Markdown 或 MDX 撰写文章,内容具备类型安全,并包含草稿、分页、可折叠目录以及亮色与暗色模式。
astro-paper 可以免费使用吗?用的什么许可证?
astro-paper 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
astro-paper 还在维护吗?
活跃维护中。astro-paper 最近一次提交是在 2026年10月21日。
astro-paper 适合用来做什么?
在静态托管平台上搭建个人或技术博客 发布带草稿与分页功能的写作站点 需要无后端搜索的 Markdown 博客
astro-paper 怎么安装和运行?
使用 pnpm 从模板创建新项目: pnpm create astro@latest --template satnaing/astro-paper 安装依赖: pnpm install 启动本地开发服务器: pnpm dev
在哪里获取 astro-paper?
源代码和安装说明在 GitHub 上:https://github.com/satnaing/astro-paper

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目