Mermster 用户指南

快速开始：你的第一张图表

从启动到完成一张图表，大约只需 60 秒。

1. 启动 Mermster。 欢迎界面会显示创建新图表或从 12 个内置模板中选择的选项。
2. 选择一个模板（或从空白开始）。模板涵盖流程图、时序图、类图等。点击任意模板，即可在新标签页中打开并开始编辑。
3. 左侧编辑，右侧预览。 在左侧的代码编辑器中输入 Mermaid 语法。图表会在右侧实时渲染。
4. 导出你的图表。 按 Cmd+Shift+E（macOS）或 Ctrl+Shift+E（Windows）打开导出对话框。选择 SVG、PNG 或 PDF，调整设置后保存。

就这么简单。你已经创建并导出了一张图表。

免费版与付费版

Mermster 开箱即用，所有功能均可完整使用。免费版与授权版之间的唯一区别在于导出的外观。

免费包含的功能

• 完整的 Monaco 代码编辑器，含全部 10 种主题
• 全部 12 种以上 Mermaid 图表类型
• 带平移、缩放和小地图的实时预览
• SVG、PNG 和 PDF 导出（带有小号「Made with Mermster」水印）
• 复制到剪贴板（PNG 和 SVG）
• 打印支持
• 命令面板、图表构建器、大纲导航
• 带差异对比的版本历史
• 自动保存和崩溃恢复
• 12 个内置模板和自定义模板
• 导出预设（5 个内置 + 自定义）
• 4 种色觉友好的图表配色
• 7 种界面语言

授权增加的功能

无水印的干净导出。区别仅此而已。

两种授权均为一次性购买。无订阅。包含更新。

编辑器

左侧窗格是一个功能完整的代码编辑器，基于与 Visual Studio Code 相同的技术（Monaco 编辑器）构建。它的设计目标是让编写 Mermaid 语法尽可能顺畅。

语法高亮

Mermaid 关键字、节点 ID、箭头、标签和注释都会进行颜色标注，让你一眼就能看清图表。高亮会随你选择的编辑器主题而变化。

自动补全

输入时，Mermster 会提示：

• Mermaid 关键字：图表类型（graph、sequenceDiagram、classDiagram 等）、方向（TD、LR、BT、RL）以及块关键字（loop、alt、opt、end）。
• 节点 ID：一旦你定义了某个节点，它的 ID 就可以在其他任何地方用于自动补全。这能避免拼写错误，并在大型图表中节省时间。

按 Tab 或 Enter 接受建议。

错误诊断

如果你的语法有错误，Mermster 会用红色波浪线标出问题位置，并在编辑器边栏显示说明。它会在你输入时实时更新。

查找和替换

使用 Cmd+F（macOS）或 Ctrl+F（Windows）打开查找。使用 Cmd+H / Ctrl+H 进行查找和替换。

编辑器设置

在 设置（Cmd+, / Ctrl+,）的编辑器部分自定义编辑器：

实时预览

右侧窗格会实时渲染你的图表。更改会在你停止输入约 300 毫秒后出现，因此预览既灵敏，又不会在每次按键时闪烁。

平移和缩放

• 滚动以放大和缩小。
• 在触控板上双指张合进行缩放。
• 点击并拖动以在图表中平移。
• 使用右下角的缩放控件进行精确调整。

适应视图

点击缩放控件中的 适应 按钮，可将图表缩放到完整显示在预览中。点击 1:1 恢复到实际大小。

全屏预览

按 Cmd+Shift+F（macOS）或 Ctrl+Shift+F（Windows）隐藏编辑器，让窗口只显示图表。按 Escape 返回分屏视图。这在演示时很有用。

图表小地图

对于大型图表，预览的角落会出现一个缩略总览。它会以矩形显示你当前的视图范围。点击小地图上的任意位置即可跳转到该区域。在 设置 > 预览 > 图表小地图 中切换。

图表配色

Mermster 提供四种图表配色，其中包括三种色觉友好选项：

在 设置 > 外观 > 图表配色 中更改配色。配色会同时应用于实时预览和导出的图表。

文件操作

创建新图表

按 Cmd+N（macOS）或 Ctrl+N（Windows）。你可以从空白图表开始，从 12 个内置模板中选择，或使用你自己保存的模板。

内置模板涵盖：

• 基础： 流程图、时序图、类图、ER 图、状态图
• 项目： 甘特图、时间线
• 创意： 思维导图
• 数据： 饼图、象限图
• 开发： Git 图
• 用户体验： 用户旅程图

打开文件

按 Cmd+O / Ctrl+O 打开现有的 .mmd 或 .mermaid 文件。你也可以将文件拖放到 Mermster 窗口上，或在访达或资源管理器中双击 .mmd 文件。

保存

• Cmd+S / Ctrl+S：保存。如果文件之前未保存过，系统会提示你选择位置。
• Cmd+Shift+S / Ctrl+Shift+S：另存为。

Mermster 默认使用 .mmd 扩展名。也支持 .mermaid 扩展名的文件。

多标签页编辑

每个文件都在自己的标签页中打开。每个标签页的编辑内容和撤销历史都会独立保留。

• Cmd+W / Ctrl+W：关闭当前标签页（如有未保存的更改会提示保存）。
• Cmd+Shift+T / Ctrl+Shift+T：重新打开上次关闭的标签页。

文件监视

如果你打开的文件被外部（其他编辑器、Git 操作等）修改，Mermster 会检测到更改。如果你没有未保存的编辑，它会自动重新加载。如果有，则会弹出对话框询问是从磁盘重新加载，还是保留你的版本。

最近使用的文件

欢迎界面会显示你最近打开的文件。它们也会列在 文件 菜单中。

导出图表

Mermster 可导出为三种格式：SVG、PNG 和 PDF。

导出对话框

按 Cmd+Shift+E（macOS）或 Ctrl+Shift+E（Windows）打开。每种格式都有自己的标签页，含格式专属选项：

快速导出

按 Cmd+E / Ctrl+E 立即使用你上次使用的预设导出。如果你之前从未导出过，则会改为打开完整对话框。

导出预设

将你的导出设置保存为命名预设，让你每次都能获得一致的输出。Mermster 包含 5 个内置预设：

• 快速 PNG（Retina）
• 快速 SVG
• 文档用 Retina PNG
• A4 PDF
• Letter PDF

你可以创建任意数量的自定义预设。如果你在选择预设后修改了选项，下拉菜单会显示 （已修改），提醒你设置已更改。

复制到剪贴板

• Cmd+Shift+C / Ctrl+Shift+C：复制为 PNG（用于粘贴到演示文稿、文档或聊天中）。
• 复制为 SVG 可通过命令面板或 编辑 菜单使用。

复制成功后，会有一条消息通知确认。

打印

按 Cmd+P / Ctrl+P 打开系统打印对话框。

工具与导航

命令面板

按 Cmd+K（macOS）或 Ctrl+K（Windows）打开命令面板。开始输入即可搜索任意命令：切换主题、导出、打开设置、切换面板等。每个命令旁边都会显示键盘快捷键，是一边使用一边学习快捷键的好方法。

大纲导航

按 Cmd+Shift+O / Ctrl+Shift+O 打开大纲面板。它会显示图表的结构化总览：节点、连线、参与者、状态及其他元素，按类型分组。点击任意元素即可跳转到它在编辑器中的所在行。

图表构建器

按 Cmd+Shift+B / Ctrl+Shift+B 打开图表构建器面板。它会针对你正在编辑的图表类型显示上下文相关的按钮。点击任意按钮，即可在光标位置插入对应的 Mermaid 语法，并附带可用 Tab 键切换的占位文本。

图表构建器会随你的图表类型而变化：

模板

Mermster 支持两种模板：

• 内置模板：12 个入门图表，可在欢迎界面和创建新文件时使用。
• 自定义模板：通过 文件 > 保存为模板 或命令面板，将任意图表保存为可复用的模板。为它指定名称、可选描述和分类。每次创建新文件时，你的模板都会显示在 我的模板 下。

数据安全

Mermster 会自动保护你的工作，让你无需担心丢失。

自动保存

Mermster 会定期保存你未保存工作的恢复副本。如果应用意外关闭，重新启动时你的工作还在。你可以在 设置 > 数据安全 > 自动保存间隔 中调整间隔（选项：禁用、15 秒、30 秒、1 分钟或 2 分钟）。

崩溃恢复

如果 Mermster 未正常关闭（崩溃、强制退出或断电），下次启动时会出现恢复对话框。它会列出所有有未保存更改的文档，并让你：

• 恢复：在新标签页中恢复该文档。
• 丢弃：永久删除恢复数据。
• 全部恢复 / 全部丢弃：一次性处理所有文档。

你也可以随时在命令面板中搜索 恢复未保存的工作。

版本历史

每次保存时，Mermster 都会创建一个快照。浏览以前的版本，与当前文件并排比较，并恢复任意版本。

使用 Cmd+Shift+H（macOS）或 Ctrl+Shift+H（Windows）打开版本历史，或前往 文件 > 版本历史。

在版本历史面板中，你可以：

• 比较：并排查看当前文件与所选版本的差异。
• 恢复：在新标签页中打开以前的版本。
• 删除：删除单个版本，或清除某个文件的全部历史。

在 设置 > 数据安全 > 每个文件最大版本数 中配置每个文件的最大版本数（选项：10、25、50 或 100）。相同的保存会自动跳过。

自定义

使用 Cmd+,（macOS）或 Ctrl+,（Windows）打开设置。

应用主题

Mermster 提供五种主题模式：

编辑器主题

独立于应用主题，你可以为代码编辑器选择配色方案。Mermster 包含 10 种编辑器主题：

设置为 自动（默认）可让编辑器主题自动跟随你的应用主题。在 设置 > 外观 > 编辑器主题 中更改编辑器主题。

语言

Mermster 提供 7 种语言：英语、日语（日本語）、简体中文、繁体中文（繁體中文）、西班牙语（Español）、法语（Français）和德语（Deutsch）。在 设置 > 通用 > 语言 中更改语言，或将其设置为 跟随系统 以跟随你的操作系统偏好。

功能提示

当你首次使用某些功能时，Mermster 会显示一条简短的提示，说明它的作用。提示会针对大纲导航、图表构建器、版本历史、导出预设、命令面板和图表小地图出现。如果你关闭了某条提示，可以点击功能旁边的 ? 按钮再次查看，或前往 设置 > 提示 > 重新显示所有提示。

许可证

如何激活

1. 首次导出时： Mermster 会显示激活对话框。输入你的许可证密钥，或点击购买按钮来购买。
2. 从菜单： 前往 帮助 > 激活许可证，或打开 设置 > 许可证。

粘贴你的许可证密钥（格式：XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX）并点击 激活。激活需要短暂的互联网连接，但之后你的许可证可离线使用 30 天，然后才需要再次联网核验。

如何停用

要将你的许可证转移到新电脑：

1. 打开 设置 > 许可证。
2. 点击 停用许可证。
3. 确认停用。

这会释放一个设备名额，让你可以在另一台机器上激活。如果你未停用就卸载了，请联系 mermster@viaelo.app 以恢复名额。

键盘快捷键

在 Windows 上，请将 Cmd 替换为 Ctrl。

文件

编辑

视图

导出

常见问题（FAQ）

Mermster 需要联网吗？

不需要。Mermster 完全离线运行。唯一需要联网的功能是许可证的激活／停用以及检查更新。免费版完全不需要联网。

支持哪些 Mermaid 图表类型？

全部：流程图、时序图、类图、ER 图、甘特图、状态图、思维导图、饼图、Git 图、时间线、用户旅程图、象限图，以及未来 Mermaid 版本中新增的任何类型。

我可以在多台设备上使用 Mermster 吗？

可以。个人版授权最多支持 5 台设备，商业版授权最多支持 10 台。你可以随时停用某台设备以释放名额。

我的数据会被发送到任何地方吗？

不会。Mermster 零遥测、零分析、零追踪。你的图表、文件和设置完全留在你的电脑上。唯一的网络请求是许可证核验和检查更新。

Mermster 使用什么文件格式？

标准的 .mmd 和 .mermaid 文本文件。它们都是纯文本。用 Git 进行版本管理，用任何编辑器打开，随心分享。

我可以将免费版用于商业工作吗？

可以。免费版没有使用场景限制。不过，如果你在专业地分享图表，而水印并不合适，个人版（$29）或商业版（$59）授权可将其移除。

如何检查更新？

前往 帮助 > 检查更新。如果有更新的版本可用，Mermster 会通知你。

故障排除

Windows SmartScreen 警告

当你首次在 Windows 上运行 Mermster 时，可能会看到 SmartScreen 警告，提示「Windows 已保护你的电脑」。这是因为我们尚未为 Windows 购买扩展验证（EV）代码签名证书。macOS 版本已由 Apple 完整签名和公证。

继续操作：

1. 在 SmartScreen 对话框中点击 更多信息。
2. 点击 仍要运行。
3. 这只会发生一次。Windows 会记住你的选择。

图表无法渲染

如果预览显示错误而不是你的图表：

• 检查编辑器中的红色波浪线。它们表示语法错误。
• 确保你的图表以有效的类型声明开头（例如 graph TD、sequenceDiagram、classDiagram）。
• 尝试从模板创建一个新文件以确认预览正常，然后与你的代码比较。

导出看起来模糊

如果你的 PNG 导出看起来模糊，请在导出对话框中提高 DPI 设置。Retina 屏幕使用 144 DPI，印刷使用 300 DPI。若要在任意大小下都保持清晰，请改为导出 SVG。

许可证激活失败

• 检查你的互联网连接。激活需要一次性的联网核验。
• 确保你复制了完整的许可证密钥，包括连字符。
• 如果你已达到设备数量上限，请先停用一台现有设备（在该设备上的 设置 > 许可证）。
• 如果问题仍然存在，请联系 mermster@viaelo.app。

丢失了许可证密钥

用你购买时使用的邮箱发送邮件至 mermster@viaelo.app。我们可以帮你查找。

获取支持

发送邮件至 mermster@viaelo.app。你也可以在应用内通过 帮助 > 发送反馈 或 帮助 > 报告问题 联系我们。