設定
VMark 的設定面板讓你可以自訂編輯器的每個面向。使用 Mod + , 或透過選單列中的 VMark > 設定 開啟。
設定視窗有一個側邊欄，依字母順序（以英文名稱）列出各章節，「關於」放在最下方，「進階」顯示時則位於其下。變更會立即生效——沒有儲存按鈕。
使用側邊欄頂部的搜尋框，可依名稱或說明跨所有面板篩選設定——符合的列會集中顯示，因此你不需要知道某個設定位於哪個分類。若要將所有設定恢復為出廠預設值，請使用「關於」章節中的重設為預設值。
外觀
控制視覺主題與視窗行為。
主題
從六款色彩主題中選擇。當前主題以色塊周圍的環形標示。
| 主題 | 背景 | 風格 |
|---|---|---|
| 白色 | #FFFFFF | 純淨白，對比度最高 |
| 紙張 | #EEEDED | 暖調新聞紙（預設） |
| 薄荷 | #CCE6D0 | 柔和綠色，護眼 |
| 棕褐 | #F9F0DB | 書頁米色，適合長時間閱讀 |
| 夜間 | #23262B | 暗色石板，適合弱光環境 |
| Solarized | #002B36 | Solarized Dark 經典配色 |
Windows 10 與 Linux 只提供白色與夜間
在 Windows 10 與 Linux 上，標題列由系統繪製，而系統只能呈現淺色或深色。因此這兩個平台只提供 白色 與 夜間，無法與系統視窗外框相符的主題會以兩者中較接近的一個顯示：紙張、薄荷與棕褐顯示為白色，Solarized 顯示為夜間。你儲存的選擇不會被變更——在 macOS 與 Windows 11 上可使用全部主題。在 Windows 11 上，標題列會採用主題本身的顏色；選單列仍以淺色或深色繪製。
跟隨系統外觀
| 設定 | 說明 | 預設 |
|---|---|---|
| 跟隨系統外觀 | 隨系統自動在淺色與深色佈景主題之間切換 | 關閉 |
啟用後，單一的主題列會被兩列取代——淺色佈景主題（系統處於淺色模式時使用，預設為紙張）與深色佈景主題（深色模式時使用，預設為夜間）。系統外觀一變更，VMark 就會立即在兩者之間切換；你手動選擇的主題會被保留，並在關閉此選項時恢復。
側邊欄
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 側邊欄樣式 | 側邊欄與工作區欄的外框樣式。全高如 macOS 內建的側邊欄般貼齊視窗邊緣，並以細分隔線與編輯區分開；卡片以圓角和陰影浮動於視窗內。同樣適用於設定視窗 | 全高 | 全高、卡片 |
視窗
| 設定 | 說明 | 預設 |
|---|---|---|
| 在標題列顯示檔案名稱 | 在 macOS 視窗標題列顯示當前檔案名稱。僅限 macOS——其他平台會隱藏此設定，因為 Windows 與 Linux 一律在系統標題列中顯示檔案名稱 | 關閉 |
| 在視窗名稱中顯示檔案夾 | 在視窗名稱中加入所在檔案夾，例如 docs | readme.md。僅限 macOS——用於區分檔案同名的視窗 | 關閉 |
在 macOS 上，VMark 會在系統標題列之上繪製自己的標題列，因此檔案名稱是該列中可選擇開啟的元素。在 Windows 與 Linux 上，系統會在視窗上方繪製真正的標題列：檔案名稱（有未儲存的變更時帶有 •）一律顯示在那裡，VMark 不會另外加上自己的標題列。
在 macOS 上，系統標題列的文字保持隱藏，但 Dock 的視窗預覽、「視窗」選單和指揮中心仍會讀取視窗名稱。無論這些設定如何，它們一律能取得檔案名稱。
專注模式
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 變暗程度 | 在專注模式下，非焦點內容變暗的強度。標準維持預設的僅變色方式；強與更強會在此基礎上逐步降低不透明度 | 標準 | 標準、強、更強 |
編輯器
字型設定、顯示、編輯行為、空白字元與大型檔案設定。
字型設計
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 拉丁字型 | 拉丁（英文）文字的字型系列 | 系統預設 | 系統預設、Athelas、Palatino、Georgia、Charter、Literata——以及任何已安裝的字型 |
| 中日韓文字型 | 中文、日文、韓文文字的字型系列 | 系統預設 | 系統預設、PingFang SC、Songti SC、Kaiti SC、Noto Serif CJK、Source Han Sans——以及任何已安裝的字型 |
| 等寬字型 | 程式碼與等寬文字的字型系列——整合終端機也使用此字型 | 系統預設 | 系統預設、SF Mono、Monaco、Menlo、Consolas、DejaVu Sans Mono、Liberation Mono、Ubuntu Mono、Noto Sans Mono、Noto Sans Mono CJK SC、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（超寬） |
使用你自己安裝的字型
上面列出的名稱只是精選清單，並非上限。三個字型選擇器各自還有一個已安裝字型區段，列出電腦上的每個字型系列，因此你安裝的字型——LXGW WenKai、Iosevka、Source Han Serif——選用方式與內建字型完全相同。
在清單最後選擇自訂…，即可改為輸入字型系列名稱。請使用系統所回報的確切名稱（macOS：字體簿；Windows：設定 → 個人化 → 字型）— 以 LXGW WenKai / 霞鹜文楷 為例，名稱是 LXGW WenKai。名稱輸入完整後字型就會立即套用；如果沒有任何變化，表示該名稱與已安裝的字型系列不符。包含引號、逗號、分號或括號的名稱會被拒絕，該列也會顯示提示。
已安裝字型僅限 macOS
macOS 會為你列出每個已安裝的字型系列。在 Windows 與 Linux 上，該區段是空的，需透過**自訂…**選用——輸入字型系列名稱的方式在三個平台上完全相同。
此選擇也會套用到 PDF 匯出，因為它透過同一個引擎、以相同的字型算繪。HTML 匯出無法將你電腦上的字型打包進去，因此匯出的頁面會退回使用讀者自己的字型，除非對方也安裝了同一個字型系列。
顯示
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 編輯器寬度 | 最大內容寬度。較寬的值適合大型螢幕；較窄的值提升可讀性 | 50em（中等） | 36em（緊湊）、42em（窄）、50em（中等）、60em（寬）、80em（超寬）、不限 |
同樣的寬度，拉丁文與中日韓文讀起來不同
編輯器寬度以 em 計算，因此以字元計的行長取決於文字系統：在 50em 下，一行拉丁文約可容納 90–100 個字元（約為排版上 45–75 字元行長的 2 倍，適合雙窗格編輯器），而一行中日韓文約可容納 50 個全形字元——正好落在中文傳統的 40–60 字範圍內。如果你主要撰寫拉丁文散文並想要書籍般的行長，請選擇 36–42em；以中日韓文為主的文件，預設值就已經是經典行長。
TIP
50em 在 18px 字型大小下約為 900px——對大多數顯示器而言是舒適的閱讀寬度。
行為
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| Tab 大小 | 按 Tab 鍵時插入的空格數 | 2 個空格 | 2 個空格、4 個空格 |
| 在新分頁中開啟檔案 | 在新分頁中開啟現有檔案，而不是重複使用目前的空白分頁 | 關閉 | 開啟 / 關閉 |
| 啟用自動配對 | 輸入左括號時自動插入對應的右括號和引號 | 開啟 | 開啟 / 關閉 |
| 中日韓文括號 | 自動配對中日韓文特定括號，如 「」 【】 《》。僅在啟用自動配對時可用 | 自動 | 關閉、自動 |
| 包含彎引號 | 自動配對 “” 和 ‘’，並將輸入的直引號 " 或 ' 轉為一對彎引號。可能與某些輸入法的智慧引號功能衝突。當中日韓文括號設為「自動」時顯示 | 開啟 | 開啟 / 關閉 |
也配對 " | 輸入右雙引號 " 時也插入 "" 配對。當輸入法在左右引號之間交替時很有用。啟用彎引號時顯示 | 關閉 | 開啟 / 關閉 |
| 複製格式 | 從所見即所得模式複製時，純文字剪貼簿欄位使用的格式 | 純文字 | 純文字、Markdown |
| 選取時複製 | 選取文字時自動複製至剪貼簿 | 關閉 | 開啟 / 關閉 |
空白字元
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 儲存時的行尾字元 | 儲存檔案時如何處理行尾字元 | 保留現有 | 保留現有、LF（\n）、CRLF（\r\n） |
| 換行視為強制換行 | 將段落內的單一換行視為強制換行（不影響區塊之間的空白行） | 關閉 | 開啟 / 關閉 |
| 保留連續換行 | 保留多個空白行，而非將其壓縮 | 開啟 | 開啟 / 關閉 |
| 儲存時的強制換行樣式 | 強制換行在儲存的 Markdown 檔案中的表示方式 | 保留現有 | 兩個空格（推薦）、保留現有、反斜線（\） |
顯示 <br> 標籤 | 在編輯器中可視地顯示 HTML 換行標籤 | 關閉 | 開啟 / 關閉 |
| 顯示不可見字元 | 將空白字元視覺化：空格顯示為 ·、定位字元顯示為 →（僅限原始碼模式）、軟換行顯示為 ↓（僅限原始碼模式）、強制換行顯示為 ⏎。列印時隱藏。切換：F3 或 檢視 → 顯示不可見字元。 | 關閉 | 開啟 / 關閉 |
TIP
兩個空格是相容性最強的強制換行樣式——在 GitHub、GitLab 和所有主要 Markdown 渲染器上均可使用。反斜線樣式在 Reddit、Jekyll 和某些舊版解析器上可能無效。
大型檔案
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 自動原始碼模式 | 以原始碼模式開啟大型檔案 —— 超過 1 MB 的檔案，或估算區塊數達 1,200 個以上的 Markdown（略過所見即所得以維持流暢效能）。你隨時可以從狀態列切換到所見即所得 | 開啟 | 開啟 / 關閉 |
| 警告大小門檻 | 開啟超過 5 MB 的檔案前顯示確認提示。50 MB 以上的檔案一律拒絕開啟 | 開啟 | 開啟 / 關閉 |
完整大型檔案處理流程說明請參閱大型檔案。
Markdown
貼上行為、版面配置與 HTML 渲染設定。
貼上與輸入
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 在搜尋中啟用正規表示式 | 在尋找與取代列中顯示 regex 切換按鈕 | 開啟 | 開啟 / 關閉 |
| 貼上模式 | 貼上時如何處理剪貼簿內容。智慧會將 HTML 轉換為 Markdown 並偵測 Markdown 語法；純文字一律貼上純文字；富文字保留原始的 HTML 格式 | 智慧 | 智慧、純文字、富文字 |
| 在所見即所得中貼上 Markdown | 在所見即所得編輯器中貼入看起來像 Markdown 的文字時，自動將其轉換為富文字內容 | 自動 | 自動、關閉 |
版面配置
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 預設分割原始碼/預覽 | 以並排的原始碼 + 即時預覽分割檢視開啟 Markdown 檔案（否則為所見即所得）。可用 Shift + F6 或 檢視 → Markdown 分割檢視 在單次工作階段中切換 | 關閉 | 開啟 / 關閉 |
| 區塊元素字型大小 | 清單、引言、表格、提示框與詳細資訊區塊的相對字型大小 | 100% | 100%、95%、90%、85% |
| 標題對齊 | 標題的文字對齊方式。僅作用於編輯器——不套用於匯出或列印 | 靠左 | 靠左、置中 |
| 圖片與圖表邊框 | 是否在圖片、Mermaid 圖表與數學區塊周圍顯示邊框。僅作用於編輯器——不套用於匯出或列印 | 無 | 無、始終、懸停時 |
| 圖片與表格對齊 | 區塊圖片和表格的水平對齊方式。僅作用於編輯器——不套用於匯出或列印 | 置中 | 置中、靠左 |
| 表格適應寬度 | 將所有表格限制在編輯器寬度內，而不允許水平捲動 | 關閉 | 開啟 / 關閉 |
| 程式碼區塊行號 | 在所見即所得編輯器的程式碼區塊內顯示行號。與「檢視」選單的 行號 互不相干，後者控制的是原始碼/分割編輯器的邊欄 | 關閉 | 開啟 / 關閉 |
Lint
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 啟用 Markdown 檢查 | 檢查常見 Markdown 問題（損壞的連結、缺少 alt 文字、標題層級跳躍、未關閉的程式碼圍欄等） | 開啟 | 開啟 / 關閉 |
完整規則清單與嚴重程度級別請參閱 Markdown Lint。
HTML 渲染
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 所見即所得中的原始 HTML | 控制原始 HTML 區塊在所見即所得模式中的渲染方式 | 淨化 | 隱藏、淨化、淨化 + 樣式 |
| 允許的 HTML 標籤 | 算繪的標籤集合範圍有多廣 | 嚴格 | 嚴格、擴充 |
| 額外允許這些標籤 | 額外允許的標籤名稱，以逗號分隔 | （空白） | 例如 kbd, samp, var |
TIP
隱藏 會收合原始 HTML，不算繪任何內容。淨化 在去除危險標籤後渲染 HTML。淨化 + 樣式 則額外保留行內 style 屬性中安全的子集。
嚴格 只允許一小組保守的標籤。擴充 另外會算繪 <svg>（及其安全的子元素）、<figure>/<figcaption>、<details>/<summary> 以及其他語意/結構標籤——全都仍經過淨化。使用 額外允許這些標籤 可在此之上加入特定的額外標籤（例如 kbd, samp, var）。
WARNING
無論這些設定為何，危險標籤（<script>、<style>、<iframe>、<form>、事件處理器……）一律會被移除——自訂標籤欄位無法重新啟用它們。允許清單的範圍只影響所見即所得預覽；檔案中的原始 HTML 永遠不會被修改。
檔案與圖片
檔案瀏覽器、儲存、文件歷史記錄、圖片處理與文件工具。
工作區
| 設定 | 說明 | 預設 |
|---|---|---|
| 工作區側欄 | 顯示左側的工作區導軌，在同一個視窗中保留多個工作區與零散檔案 | 關閉 |
導軌帶來了哪些功能，請參閱工作區導軌。
檔案瀏覽器
前兩項設定僅在開啟工作區（資料夾）時適用，並依工作區分別儲存。
| 設定 | 說明 | 預設 |
|---|---|---|
| 顯示隱藏檔案 | 在檔案總管側邊欄中顯示點檔案與隱藏的系統項目 | 關閉 |
| 顯示所有檔案 | 在檔案總管中顯示非 Markdown 檔案。非 Markdown 檔案以系統預設應用程式開啟 | 關閉 |
| 顯示副檔名 | 在側邊欄、分頁列與標題列中顯示完整檔名——notes.md 而非 notes。無論是否在工作區中，一律適用 | 開啟 |
關閉 顯示副檔名 只會隱藏 VMark 認得的副檔名。VMark 無法開啟的檔案無論如何都會保留其副檔名，因此你看到的名稱一定真實存在於磁碟上。
結束行為
| 設定 | 說明 | 預設 |
|---|---|---|
| 確認結束 | 結束時需要按兩次 Cmd+Q（或 Ctrl+Q），防止意外退出 | 開啟 |
| 關閉時最小化至系統匣 | 僅限 Windows。 關閉最後一個視窗時，VMark 會繼續在系統匣中執行，而不是結束 | 關閉 |
關閉時最小化至系統匣 只會改變最後一個視窗的行為。開啟多個視窗時，關閉其中一個仍會將它關閉；只有最後一次關閉——也就是原本會結束 VMark 的那一次——會改為把它停放到系統匣中。不會關閉任何內容，因此未儲存的工作會完全保留在原處。
- 左鍵點擊系統匣圖示即可叫回 VMark。
- 右鍵點擊可選擇 顯示 VMark 與 結束 VMark。從系統匣結束時會先把視窗叫回來，讓任何未儲存變更的提示出現在你能回應的地方。
Ctrl+Q仍照常結束。- 在 VMark 位於系統匣時關閉此設定，會在圖示消失前先把視窗叫回來，因此絕不會讓 VMark 在沒有視窗也沒有圖示的狀態下執行。
此設定不會出現在 macOS 或 Linux 上。
儲存
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 啟用自動儲存 | 編輯後自動儲存檔案 | 開啟 | 開啟 / 關閉 |
| 儲存時寫入識別區塊 | 允許 VMark 在檔案的 frontmatter 插入 vmark: 識別區塊，並在工作區建立 .vmark 資料夾，讓一致性層能追蹤該文件。適用於所有寫入：儲存、AI 與 MCP 編輯、還原舊版本和新增檔案。關閉時不會插入識別區塊，也不會建立 .vmark 資料夾；已有 .vmark 的工作區會繼續記錄其所追蹤文件的變更——即它先前記錄過的文件，或本身已帶有 vmark: 識別區塊的文件，例如你移動或簽出的已追蹤檔案。參見一致性 | 關閉 | 開啟 / 關閉 |
| 儲存間隔 | 自動儲存之間的時間。僅在啟用自動儲存時可用 | 30 秒 | 10s、30s、1 分鐘、2 分鐘、5 分鐘 |
| 保留文件歷史記錄 | 追蹤文件版本以供還原與恢復 | 開啟 | 開啟 / 關閉 |
| 最大版本數 | 每份文件保留的歷史快照數量 | 50 個版本 | 10、25、50、100 |
| 版本保留時間 | 歷史快照在清除前的最長保留時間 | 7 天 | 1 天、7 天、14 天、30 天 |
| 合併視窗 | 在此視窗內的連續自動儲存會合併為一個快照，減少儲存雜訊 | 30 秒 | 關閉、10s、30s、1 分鐘、2 分鐘 |
| 歷史記錄的最大檔案大小 | 超過此閾值的檔案不進行自動儲存的歷史記錄快照；手動儲存、MCP 儲存以及還原版本前的安全副本一律保留 | 512 KB | 256 KB、512 KB、1 MB、5 MB、不限 |
圖片
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 貼上時自動調整大小 | 在儲存至資產資料夾之前自動調整大型圖片的大小。此值為像素的最大尺寸 | 關閉 | 關閉、800px、1200px、1920px（Full HD）、2560px（2K） |
| 複製至資產資料夾 | 將貼上或拖放的圖片複製至文件的資產資料夾，而非嵌入 | 開啟 | 開啟 / 關閉 |
| 關閉時清理未使用的圖片 | 自動從資產資料夾中刪除文件不再引用的圖片。關閉文件、視窗或應用程式時皆會執行。同一資料夾中其他文件仍在引用的圖片會保留，被移除的圖片會進入系統垃圾桶 | 關閉 | 開啟 / 關閉 |
TIP
如果你經常貼上截圖或照片，請啟用 貼上時自動調整大小——無需手動調整大小即可讓資產資料夾保持輕量。
文件工具
VMark 偵測 Pandoc 以啟用匯出至其他格式（DOCX、EPUB、LaTeX 等）。點選 偵測 以掃描系統中的 Pandoc。若找到，會顯示其版本與路徑。
如需所有匯出選項的詳細資訊，請參閱匯出與列印。
整合
MCP 伺服器與 AI 供應商設定。
MCP 伺服器
MCP（模型情境協定）伺服器允許 Claude Code 和 Cursor 等外部 AI 助理以程式方式控制 VMark。
| 設定 | 說明 | 預設 |
|---|---|---|
| 啟用 MCP 伺服器 | 啟動或停止 MCP 伺服器。執行中時，狀態徽章會顯示連接埠和已連線的用戶端 | 開啟（切換） |
| 啟動時自動開始 | VMark 開啟時自動啟動 MCP 伺服器 | 開啟 |
| 自動核准儲存至新位置與精靈結果 | 讓 MCP 用戶端不經詢問即可將文件儲存到新位置，並讓精靈直接套用其結果而不顯示預覽。關閉時，MCP 儲存到新路徑的請求會被拒絕，並以提示訊息通知你。MCP 的文件寫入永遠不受此設定限制——每次寫入都會記入代理程式編輯歷史，並可從狀態列的 MCP 寫入歷史還原 | 關閉 |
伺服器執行中時，面板還會顯示：
- 連接埠——自動分配；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、OpenAI 相容服務（DeepSeek、Groq、OpenRouter……）、Google AI，或本機的 Ollama 伺服器（Ollama API）。每個都需要模型名稱與 API 金鑰——但 Ollama 的金鑰為選填。除 Google AI 外都還需要端點，有標準端點的供應商已預先填好（OpenAI 相容欄位沒有標準端點，需自行輸入）。
每個供應商的詳細設定說明，請參閱 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>）。其安全審核簽署仍在進行中，預覽中也會如此提示——請見HTML 安全模型。 |
| 程式碼檢視器 | 關閉 | 12 個唯讀檢視器（.ts、.tsx、.js、.jsx、.py、.rs、.go、.css、.sh、.bash、.rb、.lua）。以語法高亮的檢視器開啟，提供啟用編輯和在外部編輯器中開啟按鈕。 |
當某個分類關閉時，對應的副檔名會退回至純文字模式，檔案仍可開啟，只是不會顯示結構視圖。
預設檢視模式
支援預覽的檔案（HTML、SVG、Mermaid、JSON、YAML、TOML）會以三種檢視模式之一開啟：
| 選項 | 結果 |
|---|---|
| 原始碼 | 可編輯的原始碼窗格，佔滿全寬。 |
| 分割（預設） | 原始碼與預覽並排。 |
| 預覽 | 唯讀算繪，佔滿全寬。 |
這是新開啟分頁的預設值；每個分頁會記住自己的選擇，你也可以用畫面上的切換按鈕或 F6 / Shift + F6 切換任何分頁。
外部編輯器
針對唯讀程式碼分頁上的在外部編輯器中開啟按鈕，選取應啟動的編輯器：已知編輯器的名稱（code、zed、subl、vim…），或應用程式套件（例如 /Applications/Visual Studio Code.app）或可執行檔的完整路徑。shell、直譯器與終端機模擬器會被拒絕，不存在的路徑也是。
圖形介面設定會覆蓋所有環境變數——明確勝於隱含。留空可使用環境變數備用鏈 $VMARK_EXTERNAL_EDITOR → $VISUAL → $EDITOR → 平台預設。完整解析順序與安全閘道請見在外部編輯器中開啟。
一次性升級提示
升級至多格式支援後首次啟動時，VMark 會顯示非阻斷性的提示通知，引導你前往設定 → 格式。此提示每次安裝只出現一次——顯示或關閉後不再重複出現。
檔案類型覆寫
除了分類切換之外，你還可以透過命令面板覆寫個別檔案系列的開啟方式——設定檔案類型：純文字 / Markdown / 恢復預設。覆寫依檔案系列儲存（依副檔名，或對 .env 這類檔案依點檔案主檔名），並會跨工作階段保留。請見VMark 如何決定檔案類型。
格式 面板會列出你設定的每一項覆寫，每項以 key → format 呈現。使用各項的 × 按鈕移除單一項目，或使用 全部清除 一次移除全部——移除的項目會回復為內建規則。
語言
介面語言，以及中日韓文（Chinese、Japanese、Korean）排版規則。
介面語言
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 介面語言 | 變更選單、標籤與訊息的介面語言。立即生效 | 系統語言 | English、简体中文、繁體中文、日本語、한국어、Español、Français、Deutsch、Italiano、Português (Brasil) |
首次啟動時，VMark 會從系統的偏好語言清單中挑選第一個它支援的語言；若都不相符，則使用英文。你在這裡選擇語言後，該選擇會被保留。
中日韓文排版
以下規則會在你對選取範圍執行 格式 → 中日韓 → 格式化選取範圍（Cmd+Shift+F），或對整份檔案執行 格式 → 中日韓 → 格式化整個檔案（Alt+Cmd+Shift+F）時套用。
TIP
語言部分包含 20 種以上精細的排版切換項目。如需每條規則的詳細說明與範例，請參閱中日韓文排版。
全形標準化
| 設定 | 說明 | 預設 |
|---|---|---|
| 轉換全形字母/數字 | 將全形英數字元轉換為半形（如 ＡＢＣ 變為 ABC） | 開啟 |
| 標準化標點符號寬度 | 在中日韓文字元之間將全形逗號和句點轉換為半形 | 開啟 |
| 轉換括號 | 當內容為中日韓文時，將全形括號轉換為半形 | 開啟 |
| 轉換方括號 | 當內容為中日韓文時，將半形方括號轉換為全形 【】 | 關閉 |
間距
| 設定 | 說明 | 預設 |
|---|---|---|
| 新增中英文間距 | 在中日韓文與拉丁文字元之間插入空格 | 開啟 |
| 新增中日韓文與括號間距 | 在中日韓文字元與括號之間插入空格 | 開啟 |
| 移除貨幣間距 | 移除貨幣符號後的多餘空格（如 $ 100 變為 $100） | 開啟 |
| 移除斜線間距 | 移除斜線周圍的空格（如 A / B 變為 A/B），保留 URL | 開啟 |
| 壓縮多個空格 | 將多個連續空格縮減為單一空格 | 開啟 |
破折號與引號
| 設定 | 說明 | 預設 |
|---|---|---|
| 轉換破折號 | 在中日韓文字元之間將雙連字號（--）轉換為破折號（——） | 開啟 |
| 修正破折號間距 | 確保破折號周圍有適當的間距 | 開啟 |
| 轉換直引號 | 將直引號 " 和 ' 轉換為智慧（彎）引號 | 開啟 |
| 引號樣式 | 智慧引號轉換的目標樣式 | 彎引號 "" '' |
| 情境引號 | 中日韓文字周圍使用彎引號，純拉丁文字則保留直引號。僅在開啟「轉換直引號」時可用 | 開啟 |
| 引號切換行為 | 引號樣式切換命令在各樣式之間循環的方式——簡易在直引號 ↔ 你的偏好樣式之間切換；完整循環依序輪替所有樣式 | 簡易 |
| 修正雙引號間距 | 標準化雙引號周圍的間距 | 開啟 |
| 修正單引號間距 | 標準化單引號周圍的間距 | 開啟 |
| 中日韓文角括號 | 將繁體中文和日文文字中的彎引號轉換為角括號 「」。僅當引號樣式為「彎引號」時可用 | 關閉 |
| 巢狀角括號 | 在 「」 內將巢狀單引號轉換為 『』 | 關閉 |
章節處理
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 略過參考章節 | 執行中日韓文排版時，不格式化 ## References 與 ## Further Reading 章節——適用於引文需保持原樣的學術文件 | 關閉 | 開啟 / 關閉 |
清理
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 限制連續標點符號 | 限制重複的標點符號，如 !!! | 關閉 | 關閉、單個（!! 變 !）、雙個（!!! 變 !!） |
| 移除行尾空格 | 移除行尾的空格 | 開啟 | 開啟 / 關閉 |
| 標準化省略號 | 將帶空格的點（. . .）轉換為正確的省略號（...） | 開啟 | 開啟 / 關閉 |
| 壓縮換行 | 將三個或更多連續換行縮減為兩個 | 關閉 | 開啟 / 關閉 |
快捷鍵
檢視並自訂所有鍵盤快捷鍵。快捷鍵按類別分組（檔案、編輯、檢視、格式等）。
- 搜尋——依名稱、類別或按鍵組合過濾快捷鍵
- 點選快捷鍵 以變更其按鍵綁定。按下新的組合鍵，然後確認
- 重設——將個別快捷鍵還原為預設，或一次全部重設
- 匯出 / 匯入——將自訂綁定儲存為 JSON 檔案，並在另一台機器上匯入
完整的預設快捷鍵參考請參閱鍵盤快捷鍵。
終端機
設定整合終端機面板。使用 Ctrl + ` 開啟終端機。
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| Shell | 使用哪個 shell。需要重新啟動終端機才能生效。已儲存但不再可用的 shell 會顯示為 （無法使用），並改用預設值 | 系統預設 | 系統自動偵測的 shell（如 zsh、bash、fish） |
| 面板位置 | 終端機面板的放置位置 | 自動 | 自動（依視窗長寬比）、頂部、底部、左側、右側 |
| 面板大小 | 終端機佔用的可用空間比例。拖曳調整面板大小也會更新此值 | 40% | 10% 至 80% |
| 字型大小 | 終端機中的文字大小 | 13px | 10px 至 24px |
| 行距 | 終端機行之間的垂直間距 | 1.2（緊湊） | 1.0（緊密）至 2.0（超寬） |
| 游標樣式 | 終端機游標的形狀 | 直線 | 直線、方塊、底線 |
| 游標閃爍 | 終端機游標是否閃爍 | 開啟 | 開啟 / 關閉 |
| 選取時複製 | 自動將選取的終端機文字複製至剪貼簿 | 關閉 | 開啟 / 關閉 |
| 自動渲染對話記錄 | 在終端機 CLI 旁渲染 Claude/Codex 的 Markdown、表格和 Mermaid 圖表。啟用時會在 Claude Code 與 Codex 的設定中新增本機 SessionStart 鉤子；啟用後請重新啟動正在執行的 CLI 工作階段 | 關閉 | 開啟 / 關閉 |
| WebGL 渲染器 | 使用 GPU 加速渲染終端機。如果遇到輸入法輸入問題，請停用。需要重新啟動終端機。僅限 macOS 與 Windows，Linux 一律使用 DOM 繪製 | 開啟 | 開啟 / 關閉 |
| 遠端剪貼簿（OSC 52） | 允許終端機中執行的程式——透過 ssh 或在 tmux 內——複製到系統剪貼簿。此通道只允許寫入：讀取剪貼簿一律被拒絕，因為任何列印到終端機的輸出都可能發出讀取請求 | 開啟 | 開啟 / 關閉 |
| 回捲緩衝區 | 每個工作階段在捲動歷史中保留的輸出行數。數值越大佔用記憶體越多 | 5,000 | 1,000 / 5,000 / 10,000 / 50,000 |
| 螢幕閱讀器模式 | 將終端機輸出提供給輔助技術（VoiceOver）。基於效能考量預設關閉 | 關閉 | 開啟 / 關閉 |
這裡還有兩個平台專用的開關，預設皆為開啟：將 Option 作為 Meta 鍵（僅 macOS——將 Option 鍵視為 Meta，emacs、tmux 等工具在 Alt 前綴快捷鍵與逐詞移動時需要它；如果你需要用 Option 死鍵輸入重音字母，例如 Option + E，請關閉它）與 Shell 整合（在 Windows 上隱藏——向 zsh 與 bash 注入命令標記，以支援提示字元導覽、結束狀態標示與目前目錄追蹤；從新的終端機工作階段開始生效）。
無障礙
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 終端機提示音 | 終端機提示音（BEL）的呈現方式。視覺會在工作階段標籤上標記背景活動；聲音會播放輕柔的嗶聲，並（對背景工作階段）同時標記其標籤，方便你找到它；關閉則忽略提示音。會即時套用到執行中的工作階段 | 視覺 | 關閉、視覺、聲音 |
| 未聚焦時通知 | 當某個終端機在其 VMark 視窗未取得焦點時響鈴（例如 Claude Code 完成一輪），顯示一則系統通知（標明該視窗的文件）。讓你不必逐一盯著，也能在多個視窗之間追蹤 Claude Code。首次使用時需要授予通知權限 | 開啟 | 開啟 / 關閉 |
| 最低對比度 | 將過淡的終端機文字提升到與背景之間的最低對比度。調高可提升可讀性；關閉則停用提升。會即時套用到執行中的工作階段 | WCAG AA 級（4.5:1） | 關閉、WCAG AA 級（4.5:1）、WCAG AAA 級（7:1）、最大 |
如需工作階段、鍵盤快捷鍵與 shell 環境的更多資訊，請參閱整合終端機。
關於
顯示應用程式版本、網站與 GitHub 儲存庫連結，以及更新管理。第三方聲明連結會以系統預設的文字檔應用程式開啟 VMark 所附帶之開源軟體的授權條款全文。
更新
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 自動更新 | 定期檢查是否有新版本 | 開啟 | 開啟 / 關閉 |
| 檢查頻率 | 檢查更新的頻率。僅在開啟自動更新時可用 | 啟動時 | 啟動時、每天、每週、僅手動 |
| 自動下載更新 | 有新版本時在背景下載 | 關閉 | 開啟 / 關閉 |
| 立即檢查 | 手動觸發更新檢查 | — | — |
有更新可用時，會出現一個顯示新版本號、發布日期和版本說明的卡片。你可以 下載 更新、跳過 此版本，或——下載後——重新啟動以更新。
更新會符合你安裝 VMark 的方式
更新程式下載的是與你安裝時相同的套件格式，而不是每個平台固定一種：
| 你安裝的是 | 更新程式取得的是 |
|---|---|
macOS .dmg | 已簽署的應用程式套件 |
Windows .exe（NSIS） | .exe 安裝程式 |
Windows .msi | .msi 套件 |
Linux .deb | .deb 套件 |
Linux .rpm | .rpm 套件 |
| Linux AppImage | AppImage |
在 Linux 上，更新 .deb 或 .rpm 安裝會執行系統套件管理員，因此會要求你進行驗證——安裝系統套件需要 root 權限。AppImage 更新則會直接就地取代檔案，不需要任何提示。
如果更新卡住
檢查與下載都需要透過網路，而一個卡住而非直接失敗的連線，原本可能讓更新永遠停留在進行中。如果檢查一分鐘內沒有進展，或下載、安裝三分鐘內沒有進展，VMark 會在文件視窗中顯示一則常駐的 更新已停滯 通知。其 重試 按鈕會讓更新程式回到閒置狀態，讓你可以再試一次——本章節中的 立即檢查，或下一次自動檢查，都會從全新的檢查重新開始。
更新活動會寫入日誌檔案，因此如果問題反覆發生，值得將日誌附在錯誤回報中：
| 平台 | 日誌位置 |
|---|---|
| macOS | ~/Library/Logs/app.vmark/ |
| Windows | %LOCALAPPDATA%\app.vmark\logs\ |
| Linux | ~/.local/share/app.vmark/logs/ |
重設
| 設定 | 說明 |
|---|---|
| 重設為預設值 | 將這些面板中的設定還原為預設值。會先出現確認提示——此操作無法復原 |
有三項內容另外儲存，不會被重設：鍵盤快捷鍵的自訂（請使用快捷鍵面板中的 全部重設）、你的 AI 供應商設定，以及依工作區儲存的檔案瀏覽器設定（顯示隱藏檔案、顯示所有檔案）。介面語言會回到你的系統語言。
進階
TIP
「進階」部分預設為顯示——它提供預設開啟的內嵌瀏覽器的關閉開關。在設定視窗中按 Ctrl + Option + Cmd + D 可將其隱藏，再按一次即可恢復顯示。
開發者與系統層級設定。
連結協定
| 設定 | 說明 | 預設 |
|---|---|---|
| 自訂連結協定 | VMark 視為連結的額外 URL 協定。以標籤形式輸入每個協定 | obsidian、vscode、dict、x-dictionary |
這份清單有兩個作用。插入連結時，剪貼簿中使用這些協定的 URL 會像 https:// 一樣被辨識為連結。開啟連結時，只有協定為 http、https、mailto 或在此清單中的連結，VMark 才會交給系統開啟——因此 obsidian://open?vault=... 與 vscode://file/... 連結會在對應的應用程式中開啟，其他協定則會被拒絕。少數協定無論清單內容為何都無法啟用：javascript:、data:、file: 等。
你移除的預設協定會維持移除狀態。之後的 VMark 版本新增的預設協定，會在該版本首次啟動時加入你的清單，且只加入一次。
效能
| 設定 | 說明 | 預設 |
|---|---|---|
| 保持兩種編輯器啟用 | 同時掛載所見即所得與原始碼模式編輯器，以加快模式切換速度。會增加記憶體使用量 | 關閉 |
一致性
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 語意檢查信心度 | 檢查的答案必須有多確定，才會被記錄為判定結果。低於此值時，答案仍會保留，但標示為未知 | 0.9 | 0.7、0.8、0.9、0.95 |
什麼是檢查、判定結果如何記錄，請參閱一致性。
工作流程檔案
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 取得 Action 中繼資料 | 允許 VMark 從所參照的 GitHub Actions 取得 action.yml，以填入結構化編輯器的 with: 表單。關閉後可讓工作流程編輯器完全離線 | 開啟 | 開啟 / 關閉 |
| 可用時使用 actionlint | 如果 actionlint 可執行檔在你的 PATH 中，會對工作流程檔案執行它以取得更豐富的診斷。若未安裝該可執行檔則沒有作用 | 開啟 | 開啟 / 關閉 |
工作流程
GitHub Actions 檢視器沒有開關：開啟 .github/workflows/ 下的檔案就會顯示圖與表單編輯器，原始碼窗格的輔助功能（運算式補全、游標與畫布同步、uses: 跳至定義）也會一併載入。這裡剩下的是檢視器唯一的偏好設定，以及獨立的執行引擎。
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 保留 YAML 格式 | 透過表單面板儲存工作流程編輯時，使用 CST 來回流程保留原始 YAML 的註解、錨點、鍵順序與空行。關閉時，儲存使用較精簡的序列化器（較快但會失真） | 開啟 | 開啟 / 關閉 |
| 工作流程引擎 | 執行 VMark 自己的 YAML 工作流程檔案：工作流程檔案開啟時，原始碼旁會顯示它的步驟圖與執行 / 取消工具列，工作流程精靈也能執行。步驟可能呼叫 AI 供應商並寫入檔案，因此在你主動要求之前會保持關閉 | 關閉 | 開啟 / 關閉 |
引擎不會改變檢視器顯示的內容：無論引擎是否開啟，GitHub Actions 檔案都會在檢視器中開啟；引擎關閉時，VMark 工作流程檔案會顯示為一般的 YAML 樹狀結構。引擎關閉時，VMark 也會直接拒絕工作流程執行請求，而不只是隱藏按鈕——包括透過 MCP 送達的請求——並回報「工作流程引擎已在設定中關閉」。
這兩列都位於 開發者工具（見下文）之下——開啟開發者工具即可顯示它們。檢視器請參閱工作流程檢視器，引擎請參閱 精靈工作流程。
內嵌瀏覽器
| 設定 | 說明 | 預設 | 選項 |
|---|---|---|---|
| 內嵌瀏覽器 | 應用程式內的網頁瀏覽器（僅限 macOS）。開啟時，新增瀏覽器分頁 會出現在「檔案」選單與命令面板中，且可使用 MCP 的 browser 工具。關閉時會關閉已開啟的瀏覽器分頁，並撤除 AI 自動化介面 | 開啟 | 開啟 / 關閉 |
| AI 瀏覽器工作階段 | 選擇 Sandbox（建議，隔離且不持久保存的 AI Cookie）或 Shared profile（使用者的設定檔，前往目標網站前需經核准） | 沙箱 | 沙箱 / 共享 |
| 允許 AI 回送存取 | 允許 AI 導覽至 localhost 和回送位址。私有區域網路、中繼資料和連結本機位址範圍仍被封鎖 | 關閉 | 開啟 / 關閉 |
這些設定位於 進階 → macOS 下，且只在 macOS 上顯示。兩列 AI 相關設定只有在瀏覽器開關開啟時才會出現，而且不受開關開啟與否的影響——在你變更之前，它們會一直維持沙箱 / 封鎖回送存取。完整功能介紹請參閱內嵌瀏覽器。
平台專用
| 設定 | 說明 | 預設 | 平台 |
|---|---|---|---|
| 開啟時清除 macOS 隔離標記 | 開啟工作區時，從工作區資料夾及其中直接包含、VMark 能開啟的檔案上移除 macOS 下載隔離屬性（com.apple.quarantine）（不處理子資料夾）。否則在 VMark 執行時，macOS 可能會默默忽略你在 Finder 中雙擊已下載檔案的動作。介面中顯示為 進階 → macOS 下的 開啟工作區時清除下載隔離標記 | 開啟 | macOS |
終端機的 將 Option 作為 Meta 鍵 設定位於終端機面板中。
開發者工具
開發者工具 是實驗性與僅供開發使用之設定的持久主開關。開啟後會顯示 保留 YAML 格式 列、工作流程引擎 開關，以及 熱退出開發工具 面板（內含測試工作階段擷取、檢查、還原、清除和重新啟動的按鈕）。由於此開關會持久保存，你啟用的開發中功能在不同工作階段以及發行版中都能持續使用——不必每次開啟設定時都重新啟用開發者工具。
它也會在設定之外顯示知識庫：檢視 → 知識庫 選單項目、命令面板指令與 Ctrl + Shift + 4 快捷鍵在開啟開發者工具之前都會隱藏，因為目前任何平台的發行版都不附帶此功能所需的內容伺服器執行環境。
| 設定 | 說明 | 預設 |
|---|---|---|
| 開發者工具 | 啟用開發者模式，並顯示下方實驗性與僅供開發使用的設定 | 關閉 |