文件

常見問題

關於平台、更新、Markdown 支援、還原機制與疑難排解的常見解答，以及目前版本已知的限制。

Markion 是什麼？

Markion 是一款使用 Rust 與 GPUI GPU 加速 UI 框架打造的原生桌面 Markdown 編輯器。它提供四種檢視模式——編輯、視覺化編輯、分欄與閱讀——外加可摺疊大綱、檔案樹工作區面板、尋找取代、專注與打字機模式，以及多格式匯出。

• 授權： MIT
• 儲存庫： github.com/willmove/markion
• 問題回報： GitHub Issues

支援哪些平台？

發行版本未進行平台程式碼簽署，首次啟動仍可能看到 Gatekeeper（macOS）或 SmartScreen（Windows）警告，手動放行即可執行。Windows x86_64 的應用內更新器會單獨用 Minisign 金鑰驗證其 NSIS 負載，但這不會消除 SmartScreen 提示；macOS 和 Linux 的更新操作會在系統瀏覽器中打開發行下載。透過 .deb 安裝的 Linux 使用者會自動引入所需的執行時期程式庫（Wayland / X11 / Vulkan / fontconfig）。

支援哪些 Markdown 語法？

Markion 使用 pulldown-cmark（CommonMark + GFM），並啟用了：

• CommonMark 基線
• GitHub Flavored Markdown：表格、刪除線、工作清單、自動連結
• 註腳
• 數學公式（$行內$ 與 $$區塊$$）
• ```mermaid Mermaid 圖表（圍欄程式碼區塊——流程圖、時序圖等）
• 智慧標點（彎引號、破折號）
• 標題屬性
• YAML 前言（--- 分隔，title / author / date 用於匯出）
• 擴展行內語法（Markion 特有，疊加在 pulldown-cmark 文字段之上）：==醒目==、^上標^、~下標~、emoji 短代碼（如 :smile:、:heart:）、裸自動連結

詳見 Markdown 與繪製。註腳始終啟用，沒有單獨的開關。

四種檢視模式有什麼差別？

用 Ctrl+Shift+V 在四種模式間循環（預設視覺化編輯），或用 Ctrl+//Ctrl+E/Ctrl+P/Ctrl+R直達：編輯（僅原始碼）、視覺化編輯（所見即所得優先、基於原始碼）、分欄（左原始碼右預覽）、閱讀（僅繪製預覽，不可編輯）。切換模式會保留目前文件、游標/選區、復原歷史與每個標籤頁的捲動狀態。詳見 編輯模式。

數學公式如何排版？

螢幕繪製（分欄/閱讀預覽與視覺化編輯）使用內嵌的 RaTeX 引擎（相容 KaTeX、內嵌字型）把 $行內$ 與 $$區塊$$ 公式排版為快取的 SVG——無需連網，也無需安裝外部 LaTeX。LaTeX 匯出保留原生 $...$/$$...$$ 原始碼交給讀者自己的工具鏈；內建 DOCX 匯出會將公式降級為可讀的 Unicode 純文字近似顯示。

自動儲存與當機還原如何運作？

Markion 預設在停止輸入 5 秒後寫入還原快照，並將已命名文件靜默儲存回原檔。可在「偏好設定 → 一般」關閉靜默儲存或調整 1–300 秒延遲。關閉靜默儲存仍保留還原保護；只有將 enabled = false 才會停用兩者：

[auto_save]
enabled = true
silent_save = true
delay_secs = 5

對於從未儲存到檔案的文件，Markion 會向還原目錄寫入還原副本；如果 Markion 意外結束，下次啟動會提供從該副本還原未儲存工作的選項。存在未儲存變更時，標題列會在檔名旁顯示 * 後綴。

大文件效能如何？

Markion 依文件版本快取派生狀態（預覽區塊、大綱、統計資訊、語法醒目提示）並透過 Arc 共享，因此在大文件中輸入不會在每次按鍵時重新派生所有內容。syntect 語法庫在啟動時於主執行緒之外載入，首次繪製保持回應。帶原始碼對應的視覺化編輯在局部編輯後增量復用可獨立解析的區域，當 Markdown 脈絡或位元組範圍無法確定時回退為完整派生；分欄/閱讀預覽的派生保持防抖與快取而非增量。Markion 仍使用 String 緩衝區而非 rope，部分語意讀取也會有意執行完整解析。

疑難排解

• macOS 提示「無法打開，因為來自身分不明的開發者」。 這是 Gatekeeper。右鍵應用程式並選擇「打開」，或在「系統設定 → 隱私權與安全性」中點選「仍要打開」。發行版本未簽署。
• Windows SmartScreen 在執行安裝程式前發出警告。 點選「更多資訊 → 仍要執行」。發行版本未簽署。
• 如何選擇 PDF 匯出後端？ 在「偏好設定 → 匯出」中選擇內建引擎或 Pandoc。預設內建引擎支援中英文排版、圖片、表格、程式碼和向量公式，無需安裝外部工具。選擇 Pandoc 時需要對應工具鏈，不可用或轉換失敗時會回退到內建引擎。狀態列會說明實際後端。
• 自訂主題沒有出現在偏好設定中。 確認 .toml 檔位於主題目錄（見 主題、語言與偏好設定中的資料目錄表），其 name 欄位已設定且非空，且沒有同名的內建主題（內建主題優先）。
• 日誌在哪裡？ 見 主題、語言與偏好設定中資料目錄表的日誌目錄欄。啟動前設定 RUST_LOG=debug 可提高日誌詳細程度。

已知限制

• 視覺化編輯以所見即所得為預設呈現契約，同時保留標準 Markdown；暫無位元組精確繪製證明的結構會以原始碼作為過渡編輯通道（登記在 WYSIWYG 涵蓋路線圖中），而不會猜測富文字樹變更；僅當可證明存在不重疊的原始碼邊界時才提供區塊級重排。
• 螢幕繪製（分欄/閱讀預覽與視覺化編輯）使用內嵌的 RaTeX 引擎排版數學公式；LaTeX 匯出保留原生 $...$/$$...$$ 原始碼交給讀者自己的工具鏈處理，內建 DOCX 匯出後援通道仍會將公式降級為可讀的純文字近似顯示，而非嵌入排版好的字形。
• 視覺化表格儲存格支援直接純文字編輯，但尚未提供儲存格內的富行內格式控制。引用式/多行圖片、畸形表格和正文中的 HTML 實體仍是 WYSIWYG 涵蓋路線圖上的已知缺口，暫時保留原始碼驅動編輯路徑。
• 一鍵更新在完成 Minisign 驗證後會安裝 Windows NSIS 版本；macOS 包取代與 Linux .deb/AppImage 自取代仍是後續工作，且更新身分驗證並非 Windows Authenticode 或 Apple 公證。
• 尚未提供完整的自訂主題安裝介面，主題檔仍需手動放入主題目錄。
• 圖片匯出是基於文件排版的靜態快照，超大文件尚未在所有派生子系統中使用 rope 或完全增量解析。

回報問題

請到 GitHub Issues 提交問題。附上 Markion 版本號（啟動日誌第一行可見）與平台資訊會更有幫助。