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 視窗上，或在 Finder 或檔案總管中按兩下 .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。你也可以在應用程式內透過 說明 > 傳送意見回饋 或 說明 > 回報問題 聯絡我們。