文件與瀏覽器分頁
中央區域的分頁不只有終端機。本章介紹另外兩種分頁:文件分頁(內建的 Markdown 與程式碼編輯器)與瀏覽器分頁(內嵌的網頁)。它們與會話分頁共用分頁列,開啟會話時也不會取代它們。
1. 文件分頁
1.1 開啟
以下情況會開啟文件分頁:
- 在任何會話中執行
vopen <file>(在設定 ▸ 一般中安裝「Vela 技能」後,在 Claude Code 中使用/vopen技能也有相同效果); - 在右側面板的「檔案」分頁中按兩下檔案,或選擇「在編輯器中開啟」;
- 從知識庫開啟筆記(請參閱本機知識庫);
- 點選分頁列右端的「新增文件」。
檢視方式依檔案類型而定:
| 類型 | 檢視 |
|---|---|
| md / markdown / mdx | Markdown 編輯器,提供「所見即所得」、「原始碼模式」與「對照模式」;預設以「所見即所得」開啟 |
| 圖片(png、jpg、jpeg、gif、webp、svg、bmp、ico、avif) | 圖片檢視器,提供「適應視窗」與「1:1」 |
| 其他所有檔案 | 程式碼編輯器,依檔名選擇語法醒目提示 |

1.2 Markdown 編輯器
- 所見即所得模式可直接以最終呈現的樣式進行編輯。輸入
/可開啟插入選單(標題、清單、待辦清單、引文、程式碼區塊、表格、數學式、圖片與分隔線)。以圍欄標記的mermaid程式碼區塊會在區塊下方算繪為圖表。 - 原始碼模式會完全依照儲存內容顯示檔案文字(包括 YAML front matter),並提供 Markdown 語法醒目提示。
- 對照模式會並排顯示所見即所得與原始碼,無論編輯哪一側,兩者都會保持同步。
- ⌘/(在 Windows 與 Linux 上為 Ctrl+/)可在所見即所得與原始碼之間切換。僅切換模式而未編輯時,檔案不會變更。
- 將圖片貼上或拖放到已儲存的文件中時,圖片會儲存到文件旁的
assets資料夾,並插入指向該圖片的相對連結。
1.3 編輯與儲存
- ⌘S 或「儲存」按鈕會將檔案寫入磁碟。分頁上的圓點表示有尚未儲存的變更。
- 目前使用中的文件每兩秒檢查一次磁碟。如果其他程式變更了檔案,會出現橫幅提供「重新載入」與「忽略」;如果您也有尚未儲存的編輯,重新載入按鈕會顯示為「重新載入(捨棄我的修改)」。如果在您開始編輯後,磁碟上的檔案有所變更,儲存時會先以「儲存衝突」對話方塊要求確認,再覆寫檔案。
- 關閉有未儲存變更的分頁時,會要求您選擇「儲存並關閉」、「不儲存關閉」或「取消」。
- ⌘F 會開啟搜尋列,提供尋找、取代、全部取代與「區分大小寫」;在每種模式下的操作方式都相同。
- 「側欄」按鈕會顯示文件的「大綱」與其所在資料夾的「目錄樹」;點選其中的檔案即可開啟。側欄可以調整寬度。
- 大於 10 MB 的檔案會以唯讀方式開啟,且只顯示前 10 MB,以免儲存時截斷檔案的其餘部分。
- 在文件分頁上按右鍵,除了一般的關閉操作外,還會提供「重新整理檔案」;Markdown 文件另外提供「匯出 PDF」。
1.4 新增文件與匯出 PDF
- 「新增文件」會開啟一份尚未存到磁碟、也不會出現在專案樹中的空白草稿。第一次儲存時會詢問儲存位置:桌面版使用系統的「另存新檔」對話方塊;瀏覽器用戶端與遠端連線視窗則會顯示「另存新檔」對話方塊,讓您在執行該會話的機器上選擇位置。語法醒目提示會依所選的檔名決定。在草稿的分頁上按右鍵,也會提供「儲存到磁碟…」。
- 「匯出 PDF」會將 Markdown 文件轉換為向量 PDF,並自動分頁及內嵌中日韓字型。桌面版會詢問檔案的儲存位置;瀏覽器用戶端則會直接下載。
2. 瀏覽器分頁(僅限桌面版)
瀏覽器分頁會在 VelaTerm 中顯示真正的網頁,方便您將說明文件、問題追蹤頁面或本機預覽放在會話旁邊。此功能僅在桌面版中提供,瀏覽器用戶端、遠端連線視窗與行動版版面均不提供。
開啟瀏覽器分頁的方式:
- 分頁列右端的「內建瀏覽器」按鈕;
- ⌘⇧B 快捷鍵;
- 在會話中執行
vopen <URL>; - 側邊欄中專案或群組右鍵選單內的「新增瀏覽器頁面」。
工具列: 「上一頁」、「下一頁」、「重新整理」(頁面載入時為「停止載入」)、網址列(「輸入網址或搜尋字詞」;不是網址的文字會以 Google 搜尋)、「以系統瀏覽器開啟」,以及包含 ChatGPT、Claude、Gemini 與 Google 的「快速存取」列。
兩種形式:
- 瀏覽器分頁:透過按鈕、⌘⇧B 或
vopen <URL>開啟。它不會儲存在專案樹中,重新啟動後也不會保留。 - 瀏覽器頁面節點:透過「新增瀏覽器頁面」建立。它是專案樹中的節點,會記住其網址,重新啟動後仍會存在。
開啟新視窗的連結: 網頁以新視窗開啟連結時(例如 target="_blank" 連結),VelaTerm 會在新的瀏覽器分頁中開啟。
獨立頁面: 分頁列右端的「遊戲中心」按鈕會以獨立頁面開啟 VelaTerm 遊戲中心。獨立頁面沒有網址列或快速存取列,只有「上一頁」、「下一頁」與「重新整理」;它所開啟的連結會留在同一個分頁中。
安全界線: 內嵌的網頁會被視為一般的外部網站。它不會取得任何 VelaTerm 權限或憑證,而且只能開啟 http 與 https 網址。
3. 各類分頁如何並存
- 會話、文件與瀏覽器分頁共用同一個分頁列,⌘1–9 可在所有分頁之間切換。
- 從樹狀結構開啟會話時,只會沿用會話分頁;文件與瀏覽器分頁一律不會被取代。
- 文件與瀏覽器分頁無法分割。⌘W 會直接將其關閉(有未儲存變更的文件會先詢問)。