原生 macOS 应用

Mac 上的 Markdown 阅读器。 用来审阅 AI Agent 写的计划和报告。

Claude Code、Codex 等 Agent 把计划、方案和分析写进 .md 文件。MoonMark 打开后,左侧是目录,正文行宽适中,表格、代码和图表都排好了版。Agent 改写文件后,MoonMark 自动重新载入,停在你读到的位置。

下载 Mac 版 试试示例文档

7 天免费试用Apple 芯片macOS 26 或更高版本

migration-plan.md由 Agent 编写

会话存储迁移:Redis → Postgres

由 Claude Code 生成 · 2026-09-28 · 待审阅

背景

会话数据现在放在单实例 Redis 里,没有开持久化。上周两次重启,各丢了约 4 万个登录态。本计划把会话移到现有的 Postgres 集群,Redis 只留作读缓存。

方案对比

方案持久化读延迟 P95改动量
A:开启 Redis AOF秒级0.8 ms小
B:迁到 Postgres事务级2.4 ms中
C:B + Redis 读缓存事务级0.9 ms中

建议选 C:持久化与 B 相同,读延迟接近现状。

迁移步骤

  • 建表 sessions,按 user_id 建索引
  • 双写:新会话同时写入 Redis 和 Postgres
  • 回填存量会话(约 120 万条)
  • 读路径切到 Postgres,Redis 降为缓存
  • 观察 7 天,再去掉对 Redis 持久化的依赖

数据流

读 未命中 写 客户端 API 服务 Redis 缓存 Postgres

回填脚本

-- 只回填未过期的会话
INSERT INTO sessions (id, user_id, data, expires_at)
SELECT id, user_id, data, expires_at
FROM staging_sessions
WHERE expires_at > now()
ON CONFLICT (id) DO NOTHING;

风险

警告WARNING

回填期间如果双写冲突,以 Postgres 为准。回填开始前,先冻结会话结构的变更。

回滚

读路径由开关 SESSION_READ_FROM_PG 控制。关掉开关就切回 Redis,不需要重新部署。

浅色
深色

选一套主题。点左侧目录跳到对应章节。点右上角 </> 看这份示例的 Markdown 原文。

##

易读

Markdown 原文里,表格是一行行竖线,图表是一段代码。MoonMark 把它们排好版再显示。

目录
标题自动生成目录,正在读的那一节会高亮。长文档里,点一下就能跳到「风险」或「回滚」。
⌃⌘S
正文行宽
正文保持易读的宽度,大屏上也不会铺满窗口。宽度有三档可选。宽表格和图表可以延伸到两侧留白。长代码行在代码块里横向滚动。
3 档宽度
六套主题
浅色有瓷白、亚麻、雾青,深色有石墨、午夜、松墨。目录、正文、代码、表格和图表一起换色。外观跟随系统的浅色或深色设置。
3 + 3
字体与字号
默认是无衬线字体。正文和代码都可以换成本机已装的任意字体。字号从 13 到 24,字重也能调。中英文之间自动加空格。
⌘+⌘−
图表、公式、代码
MoonMark 会把 Mermaid 代码画成图。每张图都可以放大、复制源码,或切换到源码。KaTeX 公式和代码高亮在本机渲染,不需要联网。
Mermaid · KaTeX

##

不丢阅读位置

你读文档时,Agent 常常在改写它。

文件变了,自动重新载入

默认情况下,磁盘上的文件一变,MoonMark 就重新载入,停在你正在读的那一段。

重新载入后,还停在同一段

##

更多细节

标签页
多份文档可以在一个窗口里用标签页打开。正文里指向其他 .md 或 .markdown 文件的链接,会在新标签页打开。
⌘O
大文件
特别大或结构特别复杂的文件会简化显示,App 保持响应。
本机渲染
文档在你的 Mac 上渲染,不需要账号。文档里的脚本不会执行。文档引用的网络图片会联网加载。

##

不做的事

这些交给别的工具。

MoonMark 只做 Markdown 阅读。

##

该用哪个

这几个工具各有所长,按你要做的事来选。

Typora
你要写 Markdown,想边写边看排版,Markdown 符号自动隐藏。
编辑器
Marked
你在别的编辑器里写,想在旁边实时预览,还要导出 PDF、HTML 或 DOCX。
预览 · 导出
Quick Look 扩展
你只想在 Finder 里看一眼排好的样子。按空格,看完关掉,不用改。
Finder
VS Code
项目本来就开在 VS Code 里。它自带的预览(⇧⌘V)也能显示公式。
代码编辑器
MoonMark
你要读 Agent 反复改写的长计划和报告:要目录,要好读,文件变了还停在原处。
阅读器

##

规格

系统
macOS 26 或更高版本,搭载 Apple 芯片的 Mac
界面
原生 macOS 窗口、菜单与快捷键
文件
.md .markdown
语法
CommonMark、GFM 表格与任务列表、脚注、Front Matter、提示块、Mermaid、KaTeX
辅助功能
减弱动态效果、增强对比度
价格
US$9.99,一次买断
试用
7 天,全部功能
许可证
每个许可证最多 3 台 Mac
账号
不需要

##

常见问题

MoonMark 是阅读器还是编辑器?
阅读器。要改文件,用你的编辑器,或者让 Agent 改写。MoonMark 会重新载入。
Claude Code、Codex 写的文件能打开吗?
能。.md 和 .markdown 文件都能打开,不管是哪个工具写的。默认情况下,文件变了会自动重新载入,停在原处。
需要什么样的 Mac?
搭载 Apple 芯片的 Mac,macOS 26 或更高版本。
要账号或联网吗?
不需要账号。渲染不用联网,Mermaid 图表和 KaTeX 公式也一样。激活许可证和加载文档里的网络图片时需要联网。
多少钱?
US$9.99,一次买断。可以先免费试用全部功能 7 天。一个许可证最多可在 3 台 Mac 上使用。购买后 14 天内申请,可以全额退款。
MoonMark 图标

MoonMark

免费试用全部功能 7 天。

一次买断,一个许可证最多可用于 3 台 Mac。
需要搭载 Apple 芯片的 Mac,macOS 26 或更高版本。