Skip to content

匯出與列印

VMark 提供多種文件匯出與分享方式。

匯出模式

資料夾模式(預設)

建立結構清晰的自包含資料夾:

MyDocument/
├── index.html
└── assets/
    ├── image1.png
    ├── image2.jpg
    └── ...

優點:

  • 提供服務時 URL 簡潔(/MyDocument/ 而非 /MyDocument.html
  • 可以單一資料夾輕鬆分享
  • 資產路徑簡單(assets/image.png
  • 適合靜態網站托管

單一檔案模式

建立單一自包含 HTML 檔案:

MyDocument.html

所有圖片以 data URI 嵌入,使其完全可攜,但檔案較大。

如何匯出

匯出 HTML

  1. 使用 檔案 → 匯出 HTML
  2. 選擇匯出位置
  3. 資料夾模式:輸入資料夾名稱(如 MyDocument
  4. 單一檔案模式:輸入帶有 .html 副檔名的檔案名稱

列印 / 匯出 PDF

  1. Cmd/Ctrl + P 或使用 檔案 → 列印
  2. 在系統列印對話框中列印或另存為 PDF

匯出至其他格式

VMark 整合了 Pandoc — 通用文件轉換器 — 可將 Markdown 匯出至其他格式。直接從選單中選擇格式:

檔案 → 匯出 → 其他格式 →

選單項目副檔名
Word (.docx).docx
EPUB (.epub).epub
LaTeX (.tex).tex
OpenDocument (.odt).odt
Rich Text (.rtf).rtf
Pure Text (.txt).txt

設定:

  1. pandoc.org/installing 安裝 Pandoc,或透過套件管理器安裝:
    • macOS:brew install pandoc
    • Windows:winget install pandoc
    • Linux:apt install pandoc
  2. 重新啟動 VMark(或至 設定 → 檔案與圖片 → 文件工具 並點選 偵測
  3. 使用 檔案 → 匯出 → 其他格式 → [格式] 進行匯出

如果未安裝 Pandoc,選單底部的「其他格式」子選單會顯示 "需要 Pandoc — pandoc.org" 連結。

你可以在 設定 → 檔案與圖片 → 文件工具 中確認 Pandoc 是否已被偵測到。

複製為 HTML

Cmd/Ctrl + Shift + C,將渲染後的 HTML 複製至剪貼簿,以貼入其他應用程式。

VMark 閱讀器

當你匯出為 HTML(樣式模式)時,你的文件會包含 VMark 閱讀器 — 一個具備強大功能的互動式閱讀體驗。

設定面板

點選設定圖示(右下角)或按 Esc 開啟設定面板:

設定說明
字型大小調整文字大小(12px–24px)
行距調整行間距(1.2–2.0)
主題切換主題(White、Paper、Mint、Sepia、Night)
中英文間距切換中日韓文與拉丁文字元之間的間距

目錄

目錄側邊欄有助於在長文件中導覽:

  • 切換:點選面板標頭或按 T
  • 導覽:點選任意標題跳至該處
  • 鍵盤:使用 / 鍵移動,Enter 跳至
  • 高亮:滾動時,當前章節會被高亮顯示

閱讀進度

頁面頂部有一條細微的進度條,顯示你在文件中的閱讀進度。

返回頂部

向下滾動時會出現一個浮動按鈕。點選它或按 Home 返回頂部。

圖片燈箱

點選任意圖片可在全螢幕燈箱中檢視:

  • 關閉:點選外部、按 Esc 或點選 X 按鈕
  • 導覽:使用 / 鍵在多張圖片之間切換
  • 縮放:圖片以原始大小顯示

程式碼區塊

每個程式碼區塊包含互動式控制項:

按鈕功能
行號切換顯示/隱藏此區塊的行號
複製按鈕將程式碼複製至剪貼簿

複製成功時,複製按鈕會顯示勾選標記。

腳注導覽

腳注完全支援互動:

  • 點選腳注參考 [1] 跳至其定義
  • 點選 反向連結返回你正在閱讀的位置

鍵盤快捷鍵

按鍵操作
Esc切換設定面板
T切換目錄
/ 導覽目錄項目
Enter跳至選取的目錄項目
/ 在燈箱中導覽圖片
Home捲動至頂部

匯出快捷鍵

操作快捷鍵
匯出 HTML(僅限選單)
列印Mod + P
複製為 HTMLMod + Shift + C

提示

提供匯出的 HTML

資料夾匯出結構適用於任何靜態檔案伺服器:

bash
# Python
cd MyDocument && python -m http.server 8000

# Node.js (npx)
npx serve MyDocument

# 直接開啟
open MyDocument/index.html

離線檢視

兩種匯出模式均可完全離線使用:

  • 資料夾模式:在任意瀏覽器中開啟 index.html
  • 單一檔案模式:直接開啟 .html 檔案

數學公式(KaTeX)需要網際網路連線以取得樣式表,其他所有內容均可離線使用。

最佳實務

  1. 使用資料夾模式 分享或托管的文件
  2. 使用單一檔案模式 透過電子郵件或聊天快速分享
  3. 加入描述性圖片替代文字 以提升無障礙性
  4. 在不同瀏覽器中測試 匯出的 HTML