設定
VMark 的設定面板讓你可以自訂編輯器的每個面向。使用 Mod + , 或透過選單列中的 VMark > 設定 開啟。
設定視窗有一個側邊欄，依主題分節列出 — 最常用的章節排在前面，「關於」與「進階」則放在最下方。變更會立即生效 — 沒有儲存按鈕。
外觀
控制視覺主題與視窗行為。
主題
從五款色彩主題中選擇。當前主題以色塊周圍的環形標示。
| 主題 | 背景 | 風格 |
|---|---|---|
| 白色 | #FFFFFF | 清爽、高對比 |
| 紙張 | #EEEDED | 暖中性色（預設） |
| 薄荷 | #CCE6D0 | 柔和綠色，護眼 |
| 棕褐 | #F9F0DB | 暖黃色，書本風格 |
| 夜間 | #23262B | 深色模式 |
語言
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 語言 | 變更選單、標籤與訊息的介面語言。立即生效 | English | English、简体中文、繁體中文、日本語、한국어、Español、Français、Deutsch、Italiano、Português (Brasil) |
視窗
| 設定 | 說明 | 預設 |
|---|---|---|
| 在標題列顯示檔案名稱 | 在 macOS 視窗標題列顯示當前檔案名稱 | 關閉 |
| 自動隱藏狀態列 | 未與狀態列互動時自動隱藏 | 關閉 |
編輯器
字型設定、顯示、編輯行為與空白字元設定。
字型設計
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 拉丁字型 | 拉丁（英文）文字的字型系列 | 系統預設 | 系統預設、Athelas、Palatino、Georgia、Charter、Literata |
| 中日韓文字型 | 中文、日文、韓文文字的字型系列 | 系統預設 | 系統預設、PingFang SC、Songti SC、Kaiti SC、Noto Serif CJK、Source Han Sans |
| 等寬字型 | 程式碼與等寬文字的字型系列 | 系統預設 | 系統預設、SF Mono、Monaco、Menlo、Consolas、JetBrains Mono、Fira Code、SauceCodePro NFM、IBM Plex Mono、Hack、Inconsolata |
| 字型大小 | 編輯器內容的基本字型大小 | 18px | 14px、16px、18px、20px、22px |
| 行距 | 行與行之間的垂直間距 | 1.8（寬鬆） | 1.4（緊湊）、1.6（標準）、1.8（寬鬆）、2.0（寬敞）、2.2（超寬） |
| 區塊間距 | 區塊元素（標題、段落、清單）之間的視覺間距，以行距的倍數計算 | 1x（標準） | 0.5x（緊密）、1x（標準）、1.5x（寬鬆）、2x（寬敞） |
| 中日韓文字元間距 | 中日韓文字元之間的額外間距，以 em 為單位 | 關閉 | 關閉、0.02em（極細）、0.03em（輕）、0.05em（標準）、0.08em（寬）、0.10em（更寬）、0.12em（超寬） |
顯示
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 編輯器寬度 | 最大內容寬度。較寬的值適合大型螢幕；較窄的值提升可讀性 | 50em（中等） | 36em（緊湊）、42em（窄）、50em（中等）、60em（寬）、80em（超寬）、不限 |
TIP
50em 在 18px 字型大小下約為 900px — 對大多數顯示器而言是舒適的閱讀寬度。
行為
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| Tab 大小 | 按 Tab 鍵時插入的空格數 | 2 個空格 | 2 個空格、4 個空格 |
| 啟用自動配對 | 輸入左括號時自動插入對應的右括號和引號 | 開啟 | 開啟 / 關閉 |
| 中日韓文括號 | 自動配對中日韓文特定括號，如 「」 【】 《》。僅在啟用自動配對時可用 | 自動 | 關閉、自動 |
| 包含彎引號 | 自動配對 "" 和 '' 字元。可能與某些輸入法的智慧引號功能衝突。當中日韓文括號設為「自動」時顯示 | 開啟 | 開啟 / 關閉 |
也配對 " | 輸入右雙引號 " 時也插入 "" 配對。當輸入法在左右引號之間交替時很有用。啟用彎引號時顯示 | 關閉 | 開啟 / 關閉 |
| 複製格式 | 從所見即所得模式複製時，純文字剪貼簿欄位使用的格式 | 純文字 | 純文字、Markdown |
| 選取時複製 | 選取文字時自動複製至剪貼簿 | 關閉 | 開啟 / 關閉 |
空白字元
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 儲存時的行尾字元 | 儲存檔案時如何處理行尾字元 | 保留現有 | 保留現有、LF（\n）、CRLF（\r\n） |
| 保留連續換行 | 保留多個空白行，而非將其壓縮 | 關閉 | 開啟 / 關閉 |
| 儲存時的強制換行樣式 | 強制換行在儲存的 Markdown 檔案中的表示方式 | 保留現有 | 兩個空格（推薦）、保留現有、反斜線（\） |
顯示 <br> 標籤 | 在編輯器中可視地顯示 HTML 換行標籤 | 關閉 | 開啟 / 關閉 |
TIP
兩個空格是相容性最強的強制換行樣式 — 在 GitHub、GitLab 和所有主要 Markdown 渲染器上均可使用。反斜線樣式在 Reddit、Jekyll 和某些舊版解析器上可能無效。
Markdown
貼上行為、版面配置與 HTML 渲染設定。
貼上與輸入
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 在搜尋中啟用正規表示式 | 在尋找與取代列中顯示 regex 切換按鈕 | 開啟 | 開啟 / 關閉 |
| 貼上模式 | VMark 如何路由剪貼簿內容 | 智慧 | 智慧、純文字 |
| 在所見即所得中貼上 Markdown | 在所見即所得編輯器中貼入看起來像 Markdown 的文字時，自動將其轉換為富文字內容 | 自動 | 自動、關閉 |
版面配置
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 區塊元素字型大小 | 清單、引言、表格、提示框與詳細資訊區塊的相對字型大小 | 100% | 100%、95%、90%、85% |
| 標題對齊 | 標題的文字對齊方式 | 靠左 | 靠左、置中 |
| 圖片與圖表邊框 | 是否在圖片、Mermaid 圖表與數學區塊周圍顯示邊框 | 無 | 無、始終、懸停時 |
| 圖片與表格對齊 | 區塊圖片和表格的水平對齊方式 | 置中 | 置中、靠左 |
Lint
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 啟用 Markdown 檢查 | 檢查常見 Markdown 問題（損壞的連結、缺少 alt 文字、標題層級跳躍、未關閉的程式碼圍欄等） | 開啟 | 開啟 / 關閉 |
完整規則清單與嚴重程度級別請參閱 Markdown Lint。
HTML 渲染
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 所見即所得中的原始 HTML | 控制原始 HTML 區塊在所見即所得模式中的渲染方式 | 隱藏 | 隱藏、淨化、淨化 + 樣式 |
TIP
隱藏 是最安全的選項 — 原始 HTML 區塊會被收合，不會渲染。淨化 在去除危險標籤後渲染 HTML。淨化 + 樣式 則額外保留行內 style 屬性。
檔案與圖片
檔案瀏覽器、儲存、文件歷史記錄、圖片處理與文件工具。
檔案瀏覽器
這些設定僅在開啟工作區（資料夾）時適用。
| 設定 | 說明 | 預設 |
|---|---|---|
| 顯示隱藏檔案 | 在檔案總管側邊欄中顯示點檔案與隱藏的系統項目 | 關閉 |
| 顯示所有檔案 | 在檔案總管中顯示非 Markdown 檔案。非 Markdown 檔案以系統預設應用程式開啟 | 關閉 |
結束行為
| 設定 | 說明 | 預設 |
|---|---|---|
| 確認結束 | 結束時需要按兩次 Cmd+Q（或 Ctrl+Q），防止意外退出 | 開啟 |
儲存
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 啟用自動儲存 | 編輯後自動儲存檔案 | 開啟 | 開啟 / 關閉 |
| 儲存間隔 | 自動儲存之間的時間。僅在啟用自動儲存時可用 | 30 秒 | 10s、30s、1 分鐘、2 分鐘、5 分鐘 |
| 保留文件歷史記錄 | 追蹤文件版本以供還原與恢復 | 開啟 | 開啟 / 關閉 |
| 最大版本數 | 每份文件保留的歷史快照數量 | 50 個版本 | 10、25、50、100 |
| 版本保留時間 | 歷史快照在清除前的最長保留時間 | 7 天 | 1 天、7 天、14 天、30 天 |
| 合併視窗 | 在此視窗內的連續自動儲存會合併為一個快照，減少儲存雜訊 | 30 秒 | 關閉、10s、30s、1 分鐘、2 分鐘 |
| 歷史記錄的最大檔案大小 | 超過此閾值的檔案不進行歷史記錄快照 | 512 KB | 256 KB、512 KB、1 MB、5 MB、不限 |
圖片
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 貼上時自動調整大小 | 在儲存至資產資料夾之前自動調整大型圖片的大小。此值為像素的最大尺寸 | 關閉 | 關閉、800px、1200px、1920px（Full HD）、2560px（2K） |
| 複製至資產資料夾 | 將貼上或拖放的圖片複製至文件的資產資料夾，而非嵌入 | 開啟 | 開啟 / 關閉 |
| 關閉時清理未使用的圖片 | 關閉文件時，自動從資產資料夾中刪除不再被文件引用的圖片 | 關閉 | 開啟 / 關閉 |
| 行內圖片大小上限 | 在 HTML/PDF 匯出中以 base64 data URL 嵌入圖片的最大大小（MB）。超過則改以連結方式引用 | 1.0 MB | 0.1 – 10 MB |
大型檔案
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 警告大小門檻 | 開啟超過此大小的檔案時顯示確認提示 | 5 MB | 開啟 / 關閉 |
| 自動原始碼模式 | 自動以原始碼模式開啟超過門檻的檔案（略過所見即所得以維持流暢效能） | 開啟 | 開啟 / 關閉 |
完整大型檔案處理流程說明請參閱 Large Files。
更新
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 檢查頻率 | 何時檢查新版 VMark | 啟動時 | 啟動時、每天、每週、手動 |
| 自動下載更新 | 偵測到更新後在背景下載發行檔 | 關閉 | 開啟 / 關閉 |
| 跳過特定版本 | 抑制特定版本的更新提示（從更新提示本身為每次更新設定） | 無 | — |
TIP
如果你經常貼上截圖或照片，請啟用 貼上時自動調整大小 — 無需手動調整大小即可讓資產資料夾保持輕量。
文件工具
VMark 偵測 Pandoc 以啟用匯出至其他格式（DOCX、EPUB、LaTeX 等）。點選 偵測 以掃描系統中的 Pandoc。若找到，會顯示其版本與路徑。
如需所有匯出選項的詳細資訊，請參閱匯出與列印。
整合
MCP 伺服器與 AI 供應商設定。
MCP 伺服器
MCP（模型情境協定）伺服器允許 Claude Code 和 Cursor 等外部 AI 助理以程式方式控制 VMark。
| 設定 | 說明 | 預設 |
|---|---|---|
| 啟用 MCP 伺服器 | 啟動或停止 MCP 伺服器。執行中時，狀態徽章會顯示連接埠和已連線的用戶端 | 開啟（切換） |
| 啟動時自動開始 | VMark 開啟時自動啟動 MCP 伺服器 | 開啟 |
| 自動核准編輯 | 不顯示預覽即直接套用 AI 發起的文件變更。請謹慎使用 | 關閉 |
伺服器執行中時，面板還會顯示：
- 連接埠 — 自動分配；AI 用戶端透過設定檔發現
- 版本 — MCP 伺服器附屬元件版本
- 工具 / 資源 — 可用 MCP 工具與資源的數量
- 已連線用戶端 — 目前已連線的 AI 用戶端數量
在 MCP 伺服器部分下方，你可以一鍵將 VMark 的 MCP 設定安裝至受支援的 AI 用戶端（Claude Desktop、Claude Code、Codex CLI、Gemini CLI）。
AI 供應商
設定驅動 AI 精靈的 AI 供應商。每次只能啟用一個供應商。
CLI 供應商 — 使用本機安裝的 AI CLI 工具（Claude、Codex、Gemini）。點選 偵測 以掃描你的 $PATH 中可用的 CLI。CLI 供應商使用你的訂閱方案，不需要 API 金鑰。
REST API 供應商 — 直接連接至雲端 API（Anthropic、OpenAI、Google AI、Ollama API）。每個供應商都需要端點、API 金鑰和模型名稱。
每個供應商的詳細設定說明，請參閱 AI 供應商。
格式
非預設格式轉接器的選擇性啟用切換，以及唯讀程式碼分頁外部編輯器指令的顯式設定。
Markdown、純文字和 YAML/YML 一律已登錄 — 這是沉穩的預設值。所有其他轉接器預設為關閉，避免升級時讓現有使用者感到意外。切換後，格式登錄檔會即時重建；已開啟的分頁會以正確的轉接器重新掛載，無需重新啟動。
完整格式清單與預覽說明，請參閱支援的格式。
格式支援
| 切換項目 | 預設 | 啟用 |
|---|---|---|
| 資料格式 | 關閉 | .json、.jsonl、.toml — 分割面板：原始碼 + 可導覽樹狀結構。支援 Cargo.toml、package.json、pyproject.toml 的結構感知預覽。 |
| 圖表與 SVG | 關閉 | .mmd（Mermaid）和 .svg — 分割面板：原始碼 + 淨化後的即時渲染。 |
| HTML 預覽 | 關閉 | .html 和 .htm — 沙盒 iframe 預覽（空的 sandbox="" 允許清單、DOMPurify、CSP <meta>）。通過 OWASP 前 20 項驗證 — 請見HTML 安全模型。 |
| 程式碼檢視器 | 關閉 | 12 個唯讀檢視器（.ts、.tsx、.js、.jsx、.py、.rs、.go、.css、.sh、.bash、.rb、.lua）。以語法高亮的檢視器開啟，提供啟用編輯和在外部編輯器中開啟按鈕。 |
當某個分類關閉時，對應的副檔名會退回至純文字模式，檔案仍可開啟，只是不會顯示結構視圖。
外部編輯器
針對唯讀程式碼分頁上的在外部編輯器中開啟按鈕，選取應啟動的編輯器。可指定應用程式套件（例如 /Applications/Visual Studio Code.app）或可執行檔。
圖形介面設定會覆蓋所有環境變數 — 明確勝於隱含。留空可使用環境變數備用鏈 $VMARK_EXTERNAL_EDITOR → $VISUAL → $EDITOR → 平台預設。完整解析順序與安全閘道請見在外部編輯器中開啟。
一次性升級提示
升級至多格式支援後首次啟動時，VMark 會顯示非阻斷性的提示通知，引導你前往設定 → 格式。此提示每次安裝只出現一次 — 顯示或關閉後不再重複出現。
語言
中日韓文（Chinese、Japanese、Korean）排版規則。這些規則會在你對選取範圍執行 格式 → 格式化中日韓文選取（Cmd+Shift+F），或對整份檔案執行 格式 → 格式化中日韓文文件（Alt+Cmd+Shift+F）時套用。
TIP
語言部分包含 20 種以上精細的排版切換項目。如需每條規則的詳細說明與範例，請參閱中日韓文排版。
全形標準化
| 設定 | 說明 | 預設 |
|---|---|---|
| 轉換全形字母/數字 | 將全形英數字元轉換為半形（如 ＡＢＣ 變為 ABC） | 開啟 |
| 標準化標點符號寬度 | 在中日韓文字元之間將全形逗號和句點轉換為半形 | 開啟 |
| 轉換括號 | 當內容為中日韓文時，將全形括號轉換為半形 | 開啟 |
| 轉換方括號 | 當內容為中日韓文時，將半形方括號轉換為全形 【】 | 關閉 |
間距
| 設定 | 說明 | 預設 |
|---|---|---|
| 新增中英文間距 | 在中日韓文與拉丁文字元之間插入空格 | 開啟 |
| 新增中日韓文與括號間距 | 在中日韓文字元與括號之間插入空格 | 開啟 |
| 移除貨幣間距 | 移除貨幣符號後的多餘空格（如 $ 100 變為 $100） | 開啟 |
| 移除斜線間距 | 移除斜線周圍的空格（如 A / B 變為 A/B），保留 URL | 開啟 |
| 壓縮多個空格 | 將多個連續空格縮減為單一空格 | 開啟 |
破折號與引號
| 設定 | 說明 | 預設 |
|---|---|---|
| 轉換破折號 | 在中日韓文字元之間將雙連字號（--）轉換為破折號（——） | 開啟 |
| 修正破折號間距 | 確保破折號周圍有適當的間距 | 開啟 |
| 轉換直引號 | 將直引號 " 和 ' 轉換為智慧（彎）引號 | 開啟 |
| 引號樣式 | 智慧引號轉換的目標樣式 | 彎引號 "" '' |
| 修正雙引號間距 | 標準化雙引號周圍的間距 | 開啟 |
| 修正單引號間距 | 標準化單引號周圍的間距 | 開啟 |
| 中日韓文角括號 | 將繁體中文和日文文字中的彎引號轉換為角括號 「」。僅當引號樣式為「彎引號」時可用 | 關閉 |
| 巢狀角括號 | 在 「」 內將巢狀單引號轉換為 『』 | 關閉 |
清理
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 限制連續標點符號 | 限制重複的標點符號，如 !!! | 關閉 | 關閉、單個（!! 變 !）、雙個（!!! 變 !!） |
| 移除行尾空格 | 移除行尾的空格 | 開啟 | 開啟 / 關閉 |
| 標準化省略號 | 將帶空格的點（. . .）轉換為正確的省略號（...） | 開啟 | 開啟 / 關閉 |
| 壓縮換行 | 將三個或更多連續換行縮減為兩個 | 開啟 | 開啟 / 關閉 |
快捷鍵
檢視並自訂所有鍵盤快捷鍵。快捷鍵按類別分組（檔案、編輯、檢視、格式等）。
- 搜尋 — 依名稱、類別或按鍵組合過濾快捷鍵
- 點選快捷鍵 以變更其按鍵綁定。按下新的組合鍵，然後確認
- 重設 — 將個別快捷鍵還原為預設，或一次全部重設
- 匯出 / 匯入 — 將自訂綁定儲存為 JSON 檔案，並在另一台機器上匯入
完整的預設快捷鍵參考請參閱鍵盤快捷鍵。
終端機
設定整合終端機面板。使用 Ctrl + ` 開啟終端機。
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| Shell | 使用哪個 shell。需要重新啟動終端機才能生效 | 系統預設 | 系統自動偵測的 shell（如 zsh、bash、fish） |
| 面板位置 | 終端機面板的放置位置 | 自動 | 自動（依視窗長寬比）、底部、右側 |
| 面板大小 | 終端機佔用的可用空間比例。拖曳調整面板大小也會更新此值 | 40% | 10% 至 80% |
| 字型大小 | 終端機中的文字大小 | 13px | 10px 至 24px |
| 行距 | 終端機行之間的垂直間距 | 1.2（緊湊） | 1.0（緊密）至 2.0（超寬） |
| 游標樣式 | 終端機游標的形狀 | 直線 | 直線、方塊、底線 |
| 游標閃爍 | 終端機游標是否閃爍 | 開啟 | 開啟 / 關閉 |
| 選取時複製 | 自動將選取的終端機文字複製至剪貼簿 | 關閉 | 開啟 / 關閉 |
| WebGL 渲染器 | 使用 GPU 加速渲染終端機。如果遇到輸入法輸入問題，請停用。需要重新啟動終端機 | 開啟 | 開啟 / 關閉 |
如需工作階段、鍵盤快捷鍵與 shell 環境的更多資訊，請參閱整合終端機。
關於
顯示應用程式版本、網站與 GitHub 儲存庫連結，以及更新管理。
更新
| 設定 | 說明 | 預設 |
|---|---|---|
| 自動更新 | 啟動時自動檢查更新 | 開啟 |
| 立即檢查 | 手動觸發更新檢查 | — |
有更新可用時，會出現一個顯示新版本號、發布日期和版本說明的卡片。你可以 下載 更新、跳過 此版本，或 — 下載後 — 重新啟動以更新。
進階
TIP
「進階」部分預設為隱藏。在設定視窗中按 Ctrl + Option + Cmd + D 以顯示。
開發者與系統層級設定。
連結協定
| 設定 | 說明 | 預設 |
|---|---|---|
| 自訂連結協定 | 插入連結時 VMark 應識別的額外 URL 協定。以標籤形式輸入每個協定 | obsidian、vscode、dict、x-dictionary |
這讓你可以建立像 obsidian://open?vault=... 或 vscode://file/... 這樣的連結，VMark 會將其視為有效的 URL。
效能
| 設定 | 說明 | 預設 |
|---|---|---|
| 保持兩種編輯器啟用 | 同時掛載所見即所得與原始碼模式編輯器，以加快模式切換速度。會增加記憶體使用量 | 關閉 |
工作流引擎
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 工作流引擎 | 為 .github/workflows/ 下的 .yml/.yaml 檔案啟用 GitHub Actions 工作流檢視器/編輯器。關閉時，這些檔案會以一般 YAML 開啟 | 關閉 | 開啟 / 關閉 |
| 保留 YAML 格式 | 透過表單面板儲存工作流編輯時，使用 CST 來回流程保留原始 YAML 的注釋、anchors、鍵順序與空行。關閉時，儲存使用較精簡的序列化器（較快但會失真） | 開啟 | 開啟 / 關閉 |
完整功能介紹請參閱 Workflow Viewer。
平台專用
| 設定 | 說明 | 預設 | 平台 |
|---|---|---|---|
| 開啟時清除 macOS 隔離標記 | 開啟帶有 macOS 隔離屬性（com.apple.quarantine）的檔案時，先在讀取前剝除該屬性。對從網路下載而原本會被 VMark 阻擋的檔案有用 | 開啟 | macOS |
| 將 Mac Option 視為 Meta（終端機） | 在整合終端機中將 macOS Option 鍵視為 Meta。emacs、tmux 等期望 Alt 前綴快捷鍵的工具需要此設定 | 關閉 | macOS |
開發者工具
啟用 開發者工具 後，會出現一個 熱退出開發工具 面板，內含測試工作階段擷取、檢查、還原、清除和重新啟動的按鈕 — 適合在開發過程中偵錯熱退出行為。