行內彈出視窗

VMark 提供情境式彈出視窗，用於編輯連結、圖片、媒體、數學、腳注等內容。這些彈出視窗在所見即所得和原始碼兩種模式下均可使用，並支援一致的鍵盤導覽。

通用鍵盤快捷鍵

所有彈出視窗共用以下鍵盤行為：

操作	快捷鍵
關閉/取消	Escape
確認/儲存	Enter
在欄位間導覽	Tab / Shift + Tab

連結彈出視窗

點擊連結會顯示其編輯彈出視窗。游標會停留在點擊的位置，因此可以繼續編輯連結文字——輸入、Backspace 和複製/貼上都會作用於文件。一旦編輯文字或將游標移出連結，彈出視窗便會立即關閉。

編輯現有連結

觸發條件： 點擊連結，或將游標置於連結中 + Mod + K

點擊後鍵盤焦點仍留在文件中；點擊 URL 欄位即可編輯連結目標。Mod + K 會將焦點直接移至 URL 欄位。

欄位：

• URL——編輯連結目標
• 開啟目標——在瀏覽器中開啟外部 URL、對 #bookmark 連結跳至對應標題，或對跨檔案連結在新分頁中開啟本機檔案
• 複製——複製 URL 至剪貼簿
• 刪除——移除連結，保留文字

不經彈出視窗直接開啟： 在連結上 Cmd + 點擊（Windows/Linux 上為 Ctrl + 點擊）可直接開啟其目標。

建立新連結

觸發條件： 選取文字 + Mod + K

智慧剪貼簿： 若剪貼簿中有 URL，會自動填入。

欄位：

• URL 輸入——輸入目標位址
• 確認——按 Enter 或點選 ✓
• 取消——按 Escape 或點選 ✗

原始碼模式

• Cmd + 點擊（Windows/Linux 上為 Ctrl + 點擊）連結 → 外部 URL 在瀏覽器中開啟，#bookmark 連結跳至對應標題，本機檔案路徑則在新分頁中開啟該檔案
• 點擊 [text](url) 語法 → 顯示編輯彈出視窗；游標仍留在 Markdown 中，可繼續輸入
• 在連結內按 Mod + K → 顯示編輯彈出視窗，焦點位於 URL 欄位

書籤連結

以 # 開頭的連結被視為書籤（內部標題連結）。點選「開啟」會跳至對應標題，而非開啟瀏覽器。

跨檔案連結

指向本機檔案的連結會在新分頁中開啟目標檔案；若連結帶有 #fragment，則會定位至對應標題。../appendix/cards.md 或 ./notes.md 等相對路徑會以目前文件所在的目錄為基準解析。絕對路徑（macOS/Linux 上的 /Users/me/notes/a.md，Windows 上的 C:\notes\a.md）會精確開啟所指定的檔案。網路路徑（\\server\share\…）不會透過連結開啟。若文件尚未命名，則只能開啟絕對路徑。

標題選擇器（書籤連結）

觸發條件： Alt + Mod + B（書籤連結）、插入 → 連結 → 書籤，或通用工具列的連結群組

書籤連結指向同一文件中的標題（[text](#heading-id)）。你不必手動輸入錨點，選擇器會列出文件中的每個標題，依層級縮排，頂端則有篩選欄位。

行為：

• ↑/↓ 在清單中移動，Enter 插入連結，Escape 關閉
• 有選取文字時，選取內容會成為連結文字；沒有選取時，則插入標題本身的文字作為連結
• 文件中沒有標題，或沒有任何項目符合篩選條件時，彈出視窗會加以說明

媒體彈出視窗（圖片、影片、音訊）

統一的彈出視窗，用於編輯所有媒體類型——圖片、影片和音訊。

編輯彈出視窗

觸發條件： 雙擊任何媒體元素（圖片、影片或音訊）

通用欄位（所有媒體類型）：

• 來源——檔案路徑或 URL

依類型分類的欄位：

欄位	圖片	影片	音訊
替代文字	是	—	—
標題	—	是	是
封面圖	—	是	—
尺寸	唯讀	—	—
行內/區塊切換	是（帶連結的圖片除外）	—	—

按鈕：

• 瀏覽——從檔案系統選取檔案
• 複製——複製來源路徑至剪貼簿
• 刪除——移除媒體元素

快捷鍵：

• Mod + Shift + I——插入新圖片
• Enter——儲存變更
• Escape——關閉彈出視窗

原始碼模式

在原始碼模式中，點擊圖片語法 ![alt](path) 會開啟相同的媒體彈出視窗。

原始碼模式也會顯示媒體的浮動預覽——圖片，或帶有原生播放控制項的影片或音訊播放器。當游標位於 ![alt](path) 內（且未選取文字），以及滑鼠懸停在該語法上時，就會出現預覽；游標的預覽優先於懸停的預覽。路徑必須以可辨識的圖片、影片或音訊副檔名結尾（或為 data:image/ URL）。媒體彈出視窗開啟時，預覽會隱藏。

圖片右鍵選單

在所見即所得模式中右鍵點擊圖片會開啟一個快速操作選單（與雙擊編輯彈出視窗分開）。

觸發條件： 右鍵點擊任何圖片

操作：

操作	描述
更換圖片	開啟檔案選擇器以替換圖片
刪除圖片	從文件中移除圖片
複製路徑	將圖片來源路徑複製到剪貼簿
在 Finder 中顯示	在檔案管理員中開啟圖片檔案位置（標籤會依平台調整）

按 Escape 關閉右鍵選單而不執行任何操作。

數學彈出視窗

編輯 LaTeX 數學表達式，並提供即時預覽。

觸發條件：

• 所見即所得： 點擊行內數學 $...$
• 原始碼： 將游標移至非空的 $...$、$$...$$ 區塊，或 ```latex / ```math 區塊內

欄位：

• LaTeX 輸入——編輯數學表達式
• 預覽——即時渲染預覽
• 錯誤顯示——顯示 LaTeX 錯誤與實用語法提示

快捷鍵：

• Mod + Enter——儲存並關閉
• Click outside——儲存並關閉（提交你的編輯）
• Escape——取消並關閉（捨棄你的編輯）
• Shift + Backspace——刪除行內數學（即使有內容也有效，僅 WYSIWYG 模式）
• Alt + Mod + M——插入新行內數學

錯誤提示

若有 LaTeX 語法錯誤，彈出視窗會顯示實用建議，如缺少大括號、未知指令或括號不對稱等。

原始碼模式

原始碼模式提供與 WYSIWYG 模式相同的可編輯數學彈窗——一個 LaTeX 輸入文字區域，下方顯示即時 KaTeX 預覽。當游標進入任何數學語法（非空的 $...$、$$...$$ 或 ```latex / ```math）時，彈窗會自動開啟。按 Mod + Enter 儲存，按 Escape 取消。在行尾輸入的空 $$ 會被視為一般文字——很可能是輸入到一半的區塊數學分隔符號——不會開啟彈窗。

腳注彈出視窗

行內編輯腳注內容。

觸發條件：

• 所見即所得： 懸停在腳注參考 [^1] 上
• 原始碼： 懸停或點擊腳注參考或腳注定義

欄位：

• 內容——多行腳注文字（自動調整高度）
• 跳至定義——跳至腳注定義位置
• 刪除——移除腳注

行為：

• 新腳注會自動聚焦內容欄位
• 文字區域隨輸入自動擴展

Wiki 連結彈出視窗

編輯 Wiki 風格連結，用於文件內部連結。

觸發條件：

• 所見即所得： 懸停在 [[target]] 上（300ms 延遲）
• 原始碼： 點擊 Wiki 連結語法

欄位：

• 目標——工作區相對路徑（.md 副檔名自動處理）
• 瀏覽——從工作區選取檔案
• 開啟——開啟連結的文件
• 複製——複製目標路徑
• 刪除——移除 Wiki 連結

表格情境選單

快速表格編輯操作。

觸發條件：

• 所見即所得： 右鍵點擊表格儲存格（相同的操作也可透過工具列使用，並有對應的鍵盤快捷鍵）
• 原始碼： 右鍵點擊表格儲存格

操作：

操作	說明
在上方/下方插入列	在游標處新增列
在左側/右側插入欄	在游標處新增欄
刪除列	移除目前列
刪除欄	移除目前欄
刪除表格	移除整個表格
欄靠左/置中/靠右對齊	設定目前欄的對齊方式
全部靠左/置中/靠右對齊	設定所有欄的對齊方式
格式化表格	自動對齊表格欄位（美化 Markdown）
符合寬度 / 自然寬度	僅限所見即所得：將此表格固定為編輯器寬度並依內容比例分配欄寬，或恢復為自然寬度

拼字檢查彈出視窗

透過建議修正拼字錯誤。

觸發條件：

• 右鍵點擊拼字錯誤的單詞（紅色底線）

操作：

• 建議——點擊以替換為建議內容
• 加入字典——停止將其標記為拼字錯誤

拖曳移動文字

在所見即所得模式中，你可以用滑鼠移動選取內容：在選取的文字上按下、拖曳——放置游標會標示它將落在何處——然後放開。這次移動是單一可復原的步驟（Mod + Z 可還原）。拖曳時按 Escape，或讓視窗失去焦點，即可取消。VMark 自行實作此功能，因為桌面外殼會攔截瀏覽器原生的拖曳事件，所以這是一個滑鼠手勢，而非系統的拖放功能。

模式比較

元素	所見即所得編輯	原始碼
連結	點擊 / Mod+K / Cmd+點擊 開啟	點擊 / Mod+K / Cmd+點擊 開啟
圖片	雙擊	點擊 
影片	雙擊	—
音訊	雙擊	—
數學	點擊	游標在公式中 → 彈窗
腳注	懸停	直接編輯
Wiki 連結	懸停	點擊
表格	工具列	右鍵選單
拼字檢查	右鍵	右鍵

彈出視窗導覽技巧

焦點流程

1. 彈出視窗開啟時，第一個輸入欄位自動獲得焦點
2. Tab 向前移動至各欄位和按鈕
3. Shift + Tab 向後移動
4. 焦點在彈出視窗內循環

快速編輯

• 簡單修改 URL：編輯後按 Enter
• 取消：從任意欄位按 Escape
• 多行內容（腳注、數學）：使用 Mod + Enter 儲存

滑鼠行為

• 點擊彈出視窗外部以關閉。預設行為是捨棄未儲存的變更；數學彈出視窗是例外，點擊外部時會提交編輯（請參閱數學彈出視窗一節）。
• 懸停彈出視窗（腳注、Wiki）在顯示前有 300ms 延遲
• 將滑鼠移回彈出視窗可保持開啟