文件

匯出

一份 Markdown 原始檔，自由轉換為交付、發布與封存所需的格式。從「匯出」選單或對應的鍵盤快速鍵發起匯出。

匯出格式

PDF 與 DOCX 後端

PDF 和 DOCX 預設使用內建引擎，無需安裝外部工具。在 偏好設定 → 匯出 中可以改用 Pandoc。只有選擇 Pandoc 後，應用才會嘗試外部工具；如果工具缺失或轉換失敗，則回退到內建引擎。狀態列會說明實際使用的後端，寫入失敗時顯示錯誤。

• 內建 PDF 使用完整排版引擎，支援中英文排版、嵌入圖片、語法醒目提示程式碼區塊、表格、註腳與向量數學公式；行內公式與正文基線對齊。
• 內建 PDF / DOCX 可嵌入可解析的本機圖片、已取得的遠端圖片和 data URI。GIF / WebP 會轉換為 PNG；DOCX 中的 SVG 會點陣化。無法讀取的圖片保留 alt 文字與位址。內建 DOCX 的數學公式仍使用可讀文字近似。
• PNG / JPEG 復用 PDF 排版模型產生連續的長圖，支援真實字型、中英文、標題、表格、程式碼和圖片，並非編輯器視窗截圖。

匯出設定

在「偏好設定 → 匯出」中設定後端、PDF 頁面大小、頁邊距、目錄與頁碼；也可以編輯設定檔。pdf_engine 僅在選擇 Pandoc 時使用：

[export]
backend = "builtin"   # "builtin"（預設）| "pandoc"
pdf_engine = "xelatex"   # 備選："pdfroff"、"tectonic" 等

[export.pdf]
page_size = "a4"      # "a4" | "letter" | "legal"
margin_mm = 25        # 頁邊距，單位毫米
toc = false           # 目錄
page_numbers = true   # 頁腳頁碼

DOCX 頁面大小、目錄和圖片策略也在「偏好設定 → 匯出」中統一設定，匯出時直接選擇儲存位置。頁面大小支援 A4 / Letter / Legal；圖片可選擇嵌入，或以 alt: url 文字表示。DOCX 目錄僅由 Pandoc 輸出；設定持久保存在設定中：

[export.docx]
page_size = "a4"              # "a4" | "letter" | "legal"
toc = false                   # 目錄（僅 pandoc 引擎）
image_policy = "embed"        # "embed" | "text-fallback"

另有兩個 DOCX 相關鍵位於 [export] 節：pandoc_path（明確指定 pandoc 執行檔；未設定時使用系統 PATH）和 reference_doc（pandoc --reference-doc 樣式範本；未設定或檔案缺失時回退到內建範本）：

[export]
backend = "pandoc"
pandoc_path = "C:/tools/pandoc.exe"       # 可選
reference_doc = "templates/my-style.docx" # 可選

YAML 前言中的 title / author / date 會進入匯出中繼資料：HTML <meta> 標籤、DOCX 文件屬性和 LaTeX 前言。如需更進階的 DOCX 自訂或 PDF 範本，可安裝 pandoc 和一個 LaTeX 引擎（如 TeX Live / MiKTeX 的 xelatex，或 groff 的 pdfroff）。

發布到微信公眾號（MarkNice）

選擇 匯出 → 發布到微信公眾號（MarkNice），Markion 會對目前記憶體文件（包括未儲存的修改）拍攝一份不可變快照，並在預設瀏覽器中開啟一個私有的本機迴路工作區。內容在本機瀏覽器中處理，不需要上傳文件即可排版。

新版工作台提供雙欄編輯、格式工具列、15 款主題、字級與段落間距控制，以及桌面 / 手機預覽。公式使用自包含的內聯 SVG，適合複製到公眾號草稿。

• Word 匯入。 將 .docx 轉換為目前瀏覽器工作階段內的 Markdown；使用「複製 MD」把內容帶回 Markion。
• 多種輸出。 複製到微信、複製 MD、儲存 HTML、儲存 Word，或透過列印對話框儲存目前主題化預覽為 PDF。瀏覽器 Word / PDF 與 Markion 原生匯出是不同流程。
• 應用資源離線可用。 編輯器、全部 15 款固定的 MarkNice 主題、marked、MathJax SVG、CSS 和字型均隨 Markion 打包，載入時無需任何外部網路。
• 瀏覽器編輯不寫回。 在瀏覽器中做的編輯只保留在該標籤頁內——不存在任何把改動儲存回 Markion 的介面。要持久修改請回到 Markion 編輯並重新發布新快照。
• 本機圖片被明確排除。 位於已儲存文件 <document>.assets 目錄下的受管圖片只能透過認證的不透明資源 ID 和瀏覽器 blob URL 預覽，無法隨貼上進入微信。存在本機圖片時，複製操作會提供取消或「不含本機圖片複製」的明確選擇，並回報被省略的數量。缺失的、未命名文件的、超出範圍的或新輸入的本機路徑保持未解析狀態。
• 遠端圖片保持原有行為。 遠端 HTTP(S) 圖片可能仍會造訪其原始主機（向圖片主機暴露瀏覽器 IP），但請求不會攜帶來自工作區的 referrer。
• 剪貼簿權限。 瀏覽器需要剪貼簿權限以使用首選的 text/html 加 text/plain 複製路徑；在豐富 API 不可用時使用基於選區的後援方案。
• 工作階段兩小時過期。 工作階段在兩小時沒有認證請求後過期，最多保留八份快照；過期後請從 Markion 重新啟動。剪貼簿權限失效時重新授權即可。