工作區管理

VMark 中的工作區是以資料夾形式開啟的專案根目錄。開啟工作區後，側邊欄會顯示檔案樹狀結構、快速開啟功能可索引所有 Markdown 檔案、終端機從專案根目錄啟動，且你的開啟分頁會在下次啟動時還原。

若未開啟工作區，你仍然可以開啟單一檔案，但無法使用檔案總管、專案內搜尋和工作階段還原。

開啟工作區

方式	操作
選單	檔案 > 開啟工作區
快速開啟	`Mod + O`，然後在底部選擇瀏覽...
拖放	從 Finder 將 Markdown 檔案拖入視窗 — VMark 自動偵測其專案根目錄並開啟工作區
最近的工作區	檔案 > 最近的工作區，選取先前的專案

開啟工作區時，VMark 會在側邊欄顯示檔案總管。若之前已開啟過此工作區，先前開啟的分頁會自動還原。

TIP

若目前視窗有未儲存的變更，VMark 會提示你在新視窗中開啟工作區，避免遺失目前的工作內容。

檔案總管

開啟工作區後，檔案總管會出現在側邊欄，顯示以工作區資料夾為根目錄的 Markdown 檔案樹狀結構。

導覽

單擊資料夾以展開或折疊
雙擊或按 Enter 開啟檔案（在分頁中）
非 Markdown 檔案以系統預設應用程式開啟
工作區首次開啟時，資料夾預設為折疊狀態；在你切換「檔案」、「大綱」、「歷史記錄」檢視之間時，資料夾的開啟狀態會被保留

全部展開 / 全部折疊

「檔案」檢視標題列中的兩個按鈕可一次切換整個樹狀結構：

全部展開資料夾 — 展開樹中每個資料夾
全部折疊資料夾 — 將每個資料夾收合回根目錄

檔案操作

右鍵點擊任意檔案或資料夾可存取情境選單：

操作	說明
開啟	在新分頁中開啟檔案
重新命名	行內編輯檔案或資料夾名稱（也可按 `F2`）
複製	建立檔案的副本
移至...	透過對話框將檔案移至其他資料夾
刪除	將檔案或資料夾移至系統垃圾桶
複製路徑	複製絕對檔案路徑至剪貼簿
在 Finder 中顯示	在 Finder 中顯示檔案（macOS）
新建檔案	在此位置建立新的 Markdown 檔案
新建資料夾	在此位置建立新資料夾

你也可以直接在樹狀結構中拖放檔案至不同資料夾。

顯示切換

預設情況下，檔案總管只顯示 Markdown 檔案並隱藏點檔案（dotfile）。兩個切換選項可更改此行為：

切換選項	快捷鍵	功能
顯示隱藏檔案	`Mod + Shift + .`（macOS）/ `Ctrl + H`（Win/Linux）	顯示點檔案和隱藏資料夾
顯示所有檔案	（設定或情境選單）	在文件旁顯示非 Markdown 檔案

這兩項設定均按工作區儲存，並在工作階段之間持久保留。

排除的資料夾

以下資料夾預設從樹狀結構中排除：

.git
node_modules

這些預設值在工作區第一次開啟時套用。

快速開啟

按 Mod + O 開啟快速開啟覆蓋層。它提供三個來源的模糊搜尋：

你之前開啟過的 最近檔案
目前視窗中的 已開啟分頁（以圓點標示）
工作區中的 所有 Markdown 檔案

輸入幾個字元即可篩選 — 搜尋為模糊匹配，因此 rme 可找到 README.md。使用方向鍵導覽，按 Enter 開啟。底部的固定 **瀏覽... ** 選項可開啟檔案對話框。

操作	快捷鍵
開啟快速開啟	`Mod + O`
在結果中導覽	`上 / 下`
開啟選取的檔案	`Enter`
關閉	`Escape`

TIP

未開啟工作區時，快速開啟仍然有效 — 它會顯示最近的檔案和已開啟的分頁，但無法搜尋檔案樹。

工作區內容搜尋

開啟工作區時，VMark 可在 markdown 與文字檔的 檔案內容（而非僅檔名）中搜尋符合項目。

操作	快捷鍵
開啟內容搜尋面板	`Mod + Shift + F`
跳至下一個結果	`Enter`（或使用方向鍵導覽）
在新分頁開啟結果	點擊符合項目預覽

每筆結果顯示檔案路徑、行號，以及反白標示符合文字的片段。符合項目的排序依據：

檔名相關性（檔名含搜尋詞的檔案優先）
標題鄰近度（標題內的符合項目優先於正文）
新近度（最近修改的檔案優先）

預設排除：node_modules/、.git/、dist/、target/、coverage/，以及你在工作區設定中加入到 排除的資料夾 的任何目錄。

隱藏檔案：除非檔案總管中啟用 顯示隱藏檔案，否則略過。

這與快速開啟不同 — 後者只搜尋檔名；內容搜尋會開啟符合的檔案，並將游標置於符合的行。

工作區設定

每個工作區都有自己的設定，在工作階段之間持久保留。設定儲存在 VMark 應用程式資料目錄中 — 不在專案資料夾內 — 所以你的工作區保持整潔。

以下設定按工作區儲存：

設定	說明
排除的資料夾	從檔案總管中隱藏的資料夾
顯示隱藏檔案	是否顯示點檔案
顯示所有檔案	是否顯示非 Markdown 檔案
最後開啟的分頁	下次開啟時還原工作階段的檔案路徑

TIP

工作區設定與資料夾路徑綁定。在同一台電腦上開啟相同資料夾，始終會還原你的設定，即使是從不同視窗開啟也一樣。

工作階段還原

關閉有工作區的視窗時，VMark 會將已開啟分頁的清單儲存至工作區設定。下次開啟同一工作區時，這些分頁會自動還原。

只有已儲存檔案路徑的分頁才會被還原（未命名分頁不會持久儲存）
若自上次工作階段以來某個檔案已被移動或刪除，會靜默跳過
工作階段資料在視窗關閉和工作區關閉（檔案 > 關閉工作區）時儲存

多視窗

每個 VMark 視窗都可以有自己獨立的工作區。這讓你可以同時處理多個專案。

檔案 > 新視窗 開啟全新視窗
在新視窗中開啟工作區不影響其他視窗
視窗大小和位置按視窗記憶

從 Finder 拖入 Markdown 檔案時，若目前視窗已有未儲存的工作，VMark 會自動在新視窗中開啟該檔案的專案。

將分頁分離至新視窗

你可以將分頁從視窗中拉出以建立新視窗：

向下拖曳分頁 超過分頁列（約 40 px）將其分離至游標位置的新視窗
水平拖曳分頁 在分頁列內重新排列其在其他分頁之間的順序
已釘選的分頁無法拖曳

手勢按方向鎖定：水平移動開始重新排列，垂直移動觸發分離。你可以在拖曳過程中將指標移出分頁列來從重新排列切換到分離。

外部變更

VMark 會監控你的工作區，以偵測其他程式（Git、外部編輯器、建置工具等）所做的變更，並保持已開啟文件同步。

未修改的檔案 在磁碟內容變更時自動重新載入。一則簡短的通知確認重新載入。
有未儲存變更的檔案 會觸發一個包含三個選項的對話框：另存新檔（將你的版本儲存至新位置）、重新載入（捨棄你的變更並從磁碟載入）或保留（保留你的編輯並將檔案標記為分歧狀態）。
已刪除的檔案 在其分頁中標記為遺失，但不會關閉——你仍然可以將內容儲存至新位置。
當多個已修改檔案同時變更時（例如 git checkout 後），VMark 會將它們批次合併至一個對話框，讓你可以全部重新載入、全部保留或逐一檢視。
若分歧檔案的磁碟內容後來與編輯器中的內容相符（例如 git checkout 還原了相同的文字），VMark 會自動清除分歧狀態，正常的自動儲存將恢復。

VMark 會過濾自身的儲存操作，因此你永遠不會因在應用程式內所做的變更而收到提示。

macOS Dock 最近項目

你在 VMark 中開啟的文件會在 macOS 中註冊，因此當你在 Dock 中右鍵點擊 VMark 圖示時，它們會出現在 最近使用的項目 子選單中。

終端機整合

整合終端機會自動使用工作區根目錄作為其工作目錄。開啟或切換工作區時，所有終端機工作階段都會 cd 至新的根目錄。

在每個終端機工作階段中，VMARK_WORKSPACE 環境變數會被設定為工作區路徑，讓你的腳本可以引用專案根目錄。

進一步了解終端機 →

Shell CLI 指令

VMark 可以安裝 vmark Shell 指令，讓你從終端機開啟檔案和資料夾。

安裝

前往 說明 > 安裝 'vmark' 指令。VMark 會在 /usr/local/bin/vmark 寫入一個小型啟動腳本，並要求你的管理員密碼（與 VS Code 安裝 code 指令的方式相同）。

用法

bash

# 開啟檔案
vmark README.md

# 以工作區方式開啟資料夾
vmark ~/projects/my-blog

# 開啟多個檔案
vmark chapter1.md chapter2.md

該指令委派給 open -b app.vmark，因此 macOS 處理單一實例行為——檔案在你現有的 VMark 視窗中開啟，而不是啟動新程序。

解除安裝

前往 說明 > 解除安裝 'vmark' 指令 以移除 /usr/local/bin/vmark。若該路徑的檔案不是由 VMark 安裝的，操作將被封鎖，並提示你手動移除。

工作區管理 ​

開啟工作區 ​

檔案總管 ​

導覽 ​

全部展開 / 全部折疊 ​

檔案操作 ​

顯示切換 ​

排除的資料夾 ​

快速開啟 ​

工作區內容搜尋 ​

最近的工作區 ​

工作區設定 ​

工作階段還原 ​

多視窗 ​

將分頁分離至新視窗 ​

外部變更 ​

macOS Dock 最近項目 ​

終端機整合 ​

Shell CLI 指令 ​

安裝 ​

用法 ​

解除安裝 ​