Astro博客

Momo — Astro 博客模板

作者 Motues

Momo 是基于 Astro 的极简中文博客模板，内置本地 CMS、pagefind 搜索与多语言，适合想少折腾配置的个人写作者。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

1 个预览视图
整体预览
作者提供的预览

查看现有预览图，更多页面尚未采集。

目前有 1 张原始预览，可打开完整图片查看设计细节。

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

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

值得关注的模板亮点

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

01

Astro 构建的极简博客，黑白主色配蓝色点缀，支持深色模式与移动端适配

02

内置本地 CMS 后台（pnpm cms），可视化编辑文章并实时预览，共用同一 Markdown 管线

03

Markdown 扩展丰富：KaTeX、Typst、Alert、GitHub/网易云卡片、注音、折叠、Expressive Code 等

04

pagefind 本地搜索，无需外部服务；含 canonical、hreflang、Open Graph、sitemap 等 SEO 配置

05

pnpm momo 命令行提供新建文章、备份恢复、一键更新与环境检查

06

支持简体中文与英文切换，配置集中在 src/config.ts

模板详细介绍

Momo 是一个用 Astro 搭建的极简博客模板，黑白为主、蓝色点缀，名字取自小红书新用户的初始昵称，设计上也强调从简出发。它把站点信息、主题开关、多语言和首页文案集中在 src/config.ts 一处配置，astro.config.mjs 的 site 与 i18n 会自动读取，减少了在多个文件之间来回改的麻烦。

在内容能力上，模板覆盖了写博客常用的部分：KaTeX 与构建期编译为 SVG 的 Typst、Alert 提示块、GitHub 与网易云音乐卡片、注音、折叠、彩虹文字等 Markdown 扩展，配合 Expressive Code；图片支持灯箱、连续多图自动拼网格以及 LQIP 弥散渐变占位。搜索用 pagefind 在本地生成索引，不依赖外部服务；评论需要配合独立的 Momo-Backend 项目，可选择本地或 Cloudflare 部署。此外还有本地 CMS 后台（pnpm cms）和一套 pnpm momo 命令行工具，用于新建文章、备份恢复、更新与环境检查。

使用门槛主要在环境上：需要 Node.js >= 22，本地 CMS 后台要求 >= 22.18，包管理指定 pnpm。评论、CMS 后台等能力依赖额外项目或本地进程，是否已接入真实后端需按 Backend 仓库自行核对；memos、v5 等分支为不定期维护，不保证与 main 一致。上线前建议先跑 pnpm momo doctor 检查环境，并确认目标部署平台的构建配置。

Astro博客

适合你的项目吗？

适用场景

  • 个人技术或生活博客，希望开箱即用又不想被复杂配置拖住
  • 偏好本地搜索与本地 CMS，不想为搜索或写作后台引入外部服务
  • 需要中英双语站点、RSS 与基础 SEO 的写作项目
  • 愿意使用 pnpm 与较新 Node.js 版本，并接受通过命令行维护模板

适合人群

  • 以 Markdown 写作为主、重视排版与阅读体验的个人作者
  • 能自行处理 Node.js 环境与 pnpm 命令的前端开发者
  • 需要评论功能并愿意额外部署 Momo-Backend 的用户

上手与定制指南

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

  1. 1

    环境要求 Node.js >= 22（推荐 24 LTS），本地 CMS 后台需 >= 22.18，包管理使用 pnpm

  2. 2

    评论功能依赖独立的 Momo-Backend 项目，支持本地或 Cloudflare 部署，接入前需核对后端是否就绪

  3. 3

    memos、v5 分支为不定期维护，不保证与 main 一致，选用前需确认分支状态

  4. 4

    更新模板可用 pnpm momo update，建议先加 --dry-run 预览；文章、图片与 src/config.ts 会保留

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
  • 评论功能依赖独立的 Momo-Backend 项目，属于额外外部服务，需单独部署与核对。
  • 环境要求 Node.js >= 22，本地 CMS 管理后台需要 >= 22.18，并指定使用 pnpm 包管理器。
  • memos、v5 等分支为不定期维护，无法保证与 main 分支一致。
  • v5 分支已停止维护。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

* **评论功能**：支持本地部署和 Cloudflare 部署，具体参考 [Backend](https://github.com/Motues/Momo-Backend)

README 原文

> 环境要求：Node.js **>= 22**（推荐 24 LTS；本地 CMS 管理后台需要 **>= 22.18**），包管理使用 [pnpm](https://pnpm.io/zh/)

README 原文

下面是一些分支，会不定期进行维护，无法保证与 `main` 分支一致

README 原文

* `v5`：v5 版本，已经停止维护

README 原文
https://github.com/Motues/Momo/blob/main/LICENSEhttps://github.com/Motues/Momo/blob/main/README.md

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

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料较完整 · 87 / 100
技术栈
Astro
网站类型
博客
这个分数如何计算

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

这个项目需要核对什么

记录的仓库更新时间
2026-09-28
截图检查日期
2026-09-30

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: 51d63c0d9bd61fa9b9c21309cee9fc72926ab3479234b0f324c4ba0636cd1646

2026-09-30T15:49:08.823Z

来源文件 / 仓库
# Momo

<div align="center">
    <img src="./doc/images/dark-light.jpg">
    <p>一个极简的Blog模板，使用 <a href="https://astro.build/">Astro</a> 搭建</p>
    <small><ins>简体中文</ins></small> <small><a href="./doc/README_en.md">English</a></small> 
</div>

## ✨ 特性

Momo 取自小红书📕，每个新用户最初的昵称，象征着初始新生。博客的设计理念也来自于此，从简约出发，在复杂功能与简约设计之间达到一种平衡。

* **极简设计**：页面设计简约，黑白为主色调，蓝色进行点缀
* **深色模式**：支持手动切换或自动跟随系统
* **移动端适配**：组件针对移动端进行优化，拥有和电脑浏览器一样的流畅体验
* **图片体验**：点击图片打开灯箱；连续放置的多张图片自动拼成网格；文章内图片支持 LQIP 弥散渐变占位
* **丰富的 Markdown 语法**：KaTeX、Typst（构建期编译为 SVG）、Alert 提示块、GitHub / 网易云音乐卡片、引用组件、注音（Ruby）、折叠、彩虹文字、下划线、新标签页链接，Expressive Code 等
* **本地搜索**：使用 [pagefind](https://pagefind.app/) 实现本地化搜索，无需外部服务
* **国际化（i18n）**：支持多语言切换，目前支持简体中文、英文
* **评论功能**：支持本地部署和 Cloudflare 部署，具体参考 [Backend](https://github.com/Motues/Momo-Backend)
* **SEO**：canonical、hreflang 多语言对照、Open Graph / Twitter Card、结构化数据、`sitemap.xml` 与 `robots.txt`
* **本地 CMS 管理后台**：`pnpm cms` 启动，可视化编辑文章与实时预览（与博客共用同一条 Markdown 管线），无需手动改 Markdown
* **命令行工具**：`pnpm momo` 提供配置备份/恢复、一键更新、新建文章、环境检查等能力
* **TypeScript**：站点源码与 `src/plugins/` 自定义插件链均使用 TypeScript 编写
* 其他基本功能：文章分类，目录，RSS订阅，字数统计，阅读时间

## 🚀 快速开始

> 环境要求：Node.js **>= 22**（推荐 24 LTS；本地 CMS 管理后台需要 **>= 22.18**），包管理使用 [pnpm](https://pnpm.io/zh/)

1. 克隆本项目
    ```bash
    git clone https://github.com/Motues/Momo.git
    cd Momo
    ```
2. 运行 `pnpm install` 安装依赖（使用 `npm install -g pnpm` 安装 `pnpm`）
3. 运行 `pnpm dev` 启动开发服务器

## 🔧 配置

参考 [配置指南](./doc/config_zh-cn.md)，详细信息可以访问 [Momo](https://momo.motues.top/intro/config)，阅读对应文章获取详细信息。

站点信息、主题开关、多语言与首页 Cover 文案统一在 `src/config.ts` 中配置；`astro.config.mjs` 的 `site` 与 `i18n` 会自动读取该文件的配置。

## 📚 更新

参考 [更新指南](./doc/release_zh-cn.md)，介绍如何更新项目，详细信息可以访问 [Momo](https://momo.motues.top/intro/release)。

执行 `pnpm momo update` 可以自动完成「检查 GitHub Release → 下载新版本源码 → 备份 → 覆盖代码 → 安装依赖」，并提示本次更新中需要手工合并的配置文件。你自己的文章与图片（`src/content`、`src/assets`、`public`）和 `src/config.ts` 会原样保留；先加 `--dry-run` 可以只预览变更、不写入任何文件。

## 🍃 分支

下面是一些分支，会不定期进行维护，无法保证与 `main` 分支一致

* `memos`：实现 Memos 卡片功能
* `v5`：v5 版本，已经停止维护

## ⚡ 指令

以下所有的指令可以在根目录下面执行

| 指令 | 作用 |
| --- | --- |
| `pnpm install` | 安装依赖 |
| `pnpm dev` | 启动本地服务器，运行在 `http://localhost:4321` |
| `pnpm build` | 构建发布版本到 `./dist` 目录下（含 pagefind 搜索索引） |
| `pnpm preview` | 预览构建后的发布版本 |
| `pnpm astro ...` | 运行 `astro` 命令，例如 `astro add` |
| `pnpm cms` | 启动本地 CMS 管理后台，运行在 `http://localhost:5188`（首次使用前先执行 `pnpm install`） |
| `pnpm momo new [path]` | 新建文章，路径省略时按日期自动生成，例如 `pnpm momo new docs/test` |
| `pnpm momo backup` | 备份 `src/config.ts` 到 `.backup/`（加 `--config` 备份全部配置文件，加 `--all` 再连同文章内容与图片） |
| `pnpm momo restore [名称]` | 从备份恢复（默认最近一次） |
| `pnpm momo update` | 从 [GitHub Release](https://github.com/Motues/Momo/releases) 更新模板代码并同步依赖（保留自己的文章与图片；`--dry-run` 预览变更） |
| `pnpm momo clean` | 清理构建产物与缓存（加 `--all` 连同 `node_modules`） |
| `pnpm momo doctor` | 检查环境、依赖与项目状态 |
| `pnpm momo --help` | 查看全部 momo 命令与选项 |


## 📚 参考

* [Astro](https://astro.build/)
* [Fuwari](https://github.com/saicaca/fuwari)
* [Tyndall](https://github.com/moyuin-aka/tyndall-public)
反馈内容错误

看看同类模板

对比同技术栈与用途的模板，找到更适合的视觉与内容结构。

astrowind

astrowind

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

Astro · 博客

astro-paper

astro-paper

A minimal, accessible and SEO-friendly Astro blog theme.

Astro · 博客

fuwari

fuwari

✨A static blog template built with Astro.

Astro · 博客

Firefly

Firefly

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

Astro · 博客

astro-theme-cactus

astro-theme-cactus

A simple Astro theme. Use it to create your blog or website.

Astro · 作品集

astrofy

astrofy

Astrofy is a free and open-source template for your Personal Portfolio Website built with Astro and TailwindCS…

Astro · 作品集