开源阅读 · 知识沉淀 · 个人知识库 Open reading · Knowledge · Personal library
墨阅Moyue
把阅读变成作品 Turn reading into a work of your own
在这个信息过载的时代，我们缺的不是内容，而是沉淀。墨阅要做的，就是帮每一个爱读书、爱写字的人，把散落的文章与笔记，汇成一座安静的数字书房。 In an age of information overload, what we lack isn't content but curation. Moyue helps every reader and writer gather scattered notes into a quiet digital library of their own.
像磨墨一样写文章，像翻书一样逛博客。 Grind ink as you write, flip pages as you browse.
它基于 Astro 5 与 Tailwind CSS v4 重写，丢掉了 Node 后端，内容即 Markdown，构建为纯静态站点。没有数据库、没有运行时依赖、没有黑盒逻辑——你的文字，就是你的网站。 Rebuilt on Astro 5 and Tailwind CSS v4, it drops the Node backend — content is Markdown, built into a static site. No database, no runtime dependency, no black boxes: your words are the website.
三个让人心动的设计 Three designs that win hearts
纯静态，零运行时 Static, zero runtime
Astro 5 + Content Collections，构建后只有 HTML/CSS/JS。秒开、低成本，可一键部署到 Gitee Pages / GitHub Pages。 Built on Astro 5 + Content Collections — the output is pure HTML/CSS/JS. Blazing fast, cheap to host, ready for Gitee Pages / GitHub Pages.
书籍三栏阅读 Three-pane book reading
专为长内容设计：左侧章节目录、中间正文、右侧内容大纲。读技术书、读大部头，像用 Kindle 般沉浸。 Made for long-form reading: chapter TOC on the left, body in the middle, outline on the right. Reading a tech book feels as immersive as a Kindle.
暖色双主题 Warm dual theme
继承「墨阅」的暖色阅读主题，并加入防闪烁的暗色模式。深夜读书，也能温柔护眼。 Inherits the warm reading theme of Moyue, plus a flicker-free dark mode. Reading late at night stays gentle on the eyes.
把一本书，搬进浏览器 Move a whole book into the browser
墨阅的书籍模块不是「一篇文章」，而是一套完整的书籍结构。 The book module isn't "one article" — it's a complete book structure.
只需在 src/content/books/ 下按 书名/章节名/内容.md 组织，再写一个 book.json，博客就会自动生成三栏阅读页。章节顺序、书籍封面、章节目录，一切都由你掌控。 Organize files as book-name/chapter-name/content.md under src/content/books/, add a book.json, and a three-pane reading page is generated automatically. Chapter order, cover and TOC — all under your control.
- 有序章节列表Ordered chapter list
- 右侧 Markdown 大纲Right-side Markdown outline
- 自动封面解析Auto cover parsing
- 阅读进度不丢失Reading progress preserved
暗下来，也温柔 Gentle, even in the dark
很多暗色模式只是「把白底变黑」，刺眼又单调。墨阅的暗色主题重新调色，让深夜阅读也能沉静如水。 Many dark modes just "turn white black" — harsh and flat. Moyue's dark theme is re-tuned, so late-night reading stays calm as water.
主题偏好保存在 localStorage，并在首屏渲染前注入，彻底杜绝闪烁。无论白天还是深夜，打开即是最舒服的阅读状态。 The theme choice is saved in localStorage and injected before first paint — no flicker, ever. Open it at noon or midnight, and it's already the most comfortable state.
博客该有的，一样不少 Everything a blog should have
墨阅不是玩具项目。它把个人博客真正会用到的能力，都打磨到了顺手。 Moyue is no toy. It polishes the capabilities a real personal blog actually needs — until they feel effortless.
- Markdown + GFM（表格、任务列表、删除线）Markdown + GFM (tables, task lists, strikethrough)
- GitHub Dark 代码高亮GitHub Dark code highlighting
- 右侧目录 + 滚动高亮（Scrollspy）Right-side TOC + scroll-spy highlighting
- 分类 / 标签 / 相关文章推荐Categories / tags / related posts
- 自动阅读时间估算Automatic reading-time estimate
- 首页分页Paginated homepage
- 自动生成 RSSAuto-generated RSS
- Giscus 评论（基于 GitHub Discussions）Giscus comments (GitHub Discussions)
而且，它也爱 Jupyter Notebook And yes, it loves Jupyter Notebook
技术博客常常需要跑代码、秀图表。墨阅支持把 .ipynb 文件直接作为文章发布，已保存的输出（图片、表格、文本、错误）都会被渲染，构建稳定，无需 Python 环境。 Technical blogs need runnable code and charts. Moyue publishes .ipynb files as posts directly — saved outputs (images, tables, text, errors) all render, builds stay stable, no Python runtime required.
三分钟，部署你的墨阅 Deploy your Moyue in three minutes
所有配置集中在 src/consts.ts，目录结构类似 Jekyll，上手几乎没有学习成本。 All config lives in src/consts.ts, with a Jekyll-like structure — almost zero learning curve.
# 克隆仓库
git clone https://gitee.com/wangyidao/moyue-blog.git
# 安装依赖
npm install
# 本地预览
npm run dev
# 构建静态站点（产物在 dist/）
npm run build 部署到 Gitee Pages 或 GitHub Pages 时，只需设置 SITE_URL 与 SITE_BASE 环境变量，即可自动适配子路径。 For Gitee Pages or GitHub Pages, just set the SITE_URL and SITE_BASE env vars and sub-paths adapt automatically.
它适合谁？ Who is it for?
读书博主 Book bloggers
想系统整理读书笔记，把一本书拆解成章节长期更新。 Want to organize notes systematically and turn a book into chapters that update over time.
技术写作者 Technical writers
需要代码高亮、Jupyter Notebook、RSS、标签聚合的工程师。 Engineers who need code highlighting, Jupyter Notebook, RSS and tag aggregation.
知识管理控 Knowledge hoarders
想用纯文本 + Git 管理自己的知识体系，拒绝复杂数据库。 Prefer plain text + Git to manage a knowledge base, and say no to heavy databases.
来，把阅读变成作品 Come, turn reading into a work
墨阅已开源。给一个 Star，Fork 一份，或者直接把它的灵魂装进你的下一座知识库。 Moyue is open source. Give it a Star, fork it, or drop its soul into your next knowledge base.
去 Gitee 看看View on Gitee