关于
一个极简的Blog模板
Momo 取自小红书📕，每个新用户最初的昵称，象征着初始新生。博客的设计理念也来自于此，从简约出发，在复杂功能与简约设计之间达到一种平衡。
✨ 特性
- 极简设计：页面设计简约，黑白为主色调，蓝色进行点缀
- 深色模式：支持手动切换或自动跟随系统
- 移动端适配：组件针对移动端进行优化，拥有和电脑浏览器一样的流畅体验
- 图片体验：点击图片打开灯箱；连续放置的多张图片自动拼成网格；文章内图片支持 LQIP 弥散渐变占位
- 丰富的 Markdown 语法：KaTeX、Typst（构建期编译为 SVG）、Alert 提示块、GitHub / 网易云音乐卡片、引用组件、注音（Ruby）、折叠、彩虹文字、下划线、新标签页链接，Expressive Code 等
- 本地搜索：使用 pagefind 实现本地化搜索，无需外部服务
- 国际化（i18n）：支持多语言切换，目前支持简体中文、英文
- 评论功能：支持本地部署和 Cloudflare 部署，具体参考 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
- 克隆本项目
Terminal window git clone https://github.com/Motues/Momo.gitcd Momo - 运行
pnpm install安装依赖（使用npm install -g pnpm安装pnpm） - 运行
pnpm dev启动开发服务器
🔧 配置
参考 配置指南，详细信息可以访问 Momo，阅读对应文章获取详细信息。
站点信息、主题开关、多语言与首页 Cover 文案统一在 src/config.ts 中配置；astro.config.mjs 的 site 与 i18n 会自动读取该文件的配置。
📚 更新
参考 更新指南，介绍如何更新项目，详细信息可以访问 Momo。
执行 pnpm momo update 可以自动完成「检查 GitHub Release → 下载新版本源码 → 备份 → 覆盖代码 → 删除新版本已移除的旧文件 → 安装依赖」，并提示本次更新中需要手工合并的配置文件。你自己的文章与图片（src/content、src/assets、public）和 src/config.ts 会原样保留；删除只针对上一版模板里有、而新版本已移除的文件（依据更新时写下的 .momo/manifest.json，你自己新增的文件不受影响，加 --no-delete 可只覆盖不删除）。先加 --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 更新模板代码并同步依赖（保留自己的文章与图片，删除新版本已移除的文件；--dry-run 预览变更，--no-delete 只覆盖不删除） |
pnpm momo clean | 清理构建产物与缓存（加 --all 连同 node_modules） |
pnpm momo doctor | 检查环境、依赖与项目状态 |
pnpm momo --help | 查看全部 momo 命令与选项 |