文件已同步至 Markion v0.3.1 · 2026-09-04

文件

Markdown 與繪製

Markion 使用 pulldown-cmark 解析 Markdown,面向 CommonMark 與 GFM。Markdown 始終是文件的唯一資料格式。

格式化命令

格式化命令支援粗體、斜體、行內程式碼、連結、圖片、標題、列表、工作清單、引用、圍欄程式碼區塊和原始碼 Markdown 表格。標題命令預設顯示 H1–H5,可在「偏好設定」中擴展為 H1–H6。

尋找與取代

支援區分大小寫、正規表示式、上一個/下一個符合、取代目前項和全部取代。

表格

  • 原始碼表格命令可格式化表格並新增、刪除或移動行列。
  • 視覺化編輯中的表格還支援直接編輯儲存格、使用 Tab 巡覽、依內容分配欄寬,以及同樣的原始碼驅動行列操作。
  • 普通預覽中的表格保持唯讀。

本機圖片工作流程

支援剪貼簿圖片和拖入的圖片檔:

  • Markion 會以抗衝突的檔名將圖片複製或編碼到文件相對的資源目錄中,並插入可攜的相對 Markdown 連結。
  • 取代既有圖片時不會遺失 alt 文字或展示中繼資料。
  • 提供實用的尺寸/對齊控制,並在資源缺失時顯示明確的缺失狀態。

YAML 前言

可解析 --- 分隔的 YAML 前言並在預覽中隱藏;其中的 title, author date 會用於匯出中繼資料(HTML <meta> 標籤、DOCX 文件屬性與 LaTeX 前言)。

繪製支援

繪製預覽支援:

  • 粗體、斜體、刪除線、行內程式碼、連結、醒目提示(==highlight==)、上標(^superscript^)、下標(~subscript~)、註腳、工作清單、常用 emoji 短代碼(如 :smile: :heart:)和自動連結。
  • 正確的有序列表起始編號、巢狀列表、分層項目符號、懸掛縮排、圖片和內嵌 HTML。
  • 智慧標點(彎引號、破折號)與標題屬性。

預覽複製

預覽文字可以選取,並透過右鍵選單複製為純文字、Markdown 或 HTML;在適用位置還可複製連結位址。

數學公式

$...$ 行內公式和 $$...$$ 區塊級公式由內嵌的 RaTeX(相容 KaTeX)引擎離線排版為帶內嵌字型的 SVG 並快取——無需連網,也無需安裝外部 LaTeX。具體表現包括:

  • 行內公式與正文保持同一行流暢排版,公式內可使用 Unicode 文字(如 $\text{速度 } v$)。
  • 公式可與加粗、連結、行內程式碼等巢狀 Markdown 結構共存並保留各自樣式。
  • ```math 圍欄區塊(如矩陣環境)。
  • 超寬公式會橫向捲動而不是被裁剪。
  • 無效公式原始碼保持可見、可編輯,不會靜默消失。
  • 在視覺化編輯中,只有聚焦的公式才顯示其完整的 $...$, $$...$$ 或圍欄原始碼。

LaTeX 匯出保留原生 $...$/$$...$$ 原始碼,交給讀者自己的工具鏈排版;內建 DOCX 匯出會將公式降級為可讀的純文字近似顯示,而非嵌入排版好的字形。

Mermaid 圖表

```mermaid 圍欄圖表(流程圖、時序圖等)繪製為經過消毒處理的 SVG 並快取。

程式碼醒目提示

使用 syntect 和 two-face 擴展語法集醒目提示圍欄程式碼,對未涵蓋語言使用後援詞法分析,並可顯示行號(可在偏好設定或 config.toml 中開關)。