CLI

先備知識：快速開始、export profiles。

安裝與 build

npm install --global @illusions-lab/mdi-cli
mdi build novel.mdi --to epub --config novel.export.json -o dist/novel.epub

mdi build <input.mdi> --to html|pdf|epub|docx|txt|txt-ruby|narou|kakuyomu|aozora|txt-all [--config export.json] [-o <output>]

input 為 UTF-8。--to 必填；-o 覆寫 output path 且不可與 txt-all 併用；--config 是 export profile JSON。成功輸出 Written <path> 並以 status 0 結束；argument/input/profile/renderer/output failure 會在 stderr 寫一行並以 status 1 結束。

每種 format 的設定

--to	預設	renderer 與 profile
html	novel.html	Rust semantic standalone HTML；不使用 page profile。
pdf	novel.pdf	Rust HTML + local Chromium；使用 print profile。
epub	novel.epub	無 config 為 Rust baseline；有 config 則用 metadata/type/chapter/cover。
docx	novel.docx	無 config 為 Rust baseline；有 config 則用 metadata/page/type/numbering。
五種 text	對應 .txt	Rust text；profile 控制 indent。aozora 是 Shift_JIS。
txt-all	6 files	輸出全部 text，拒絕 -o。

CLI 以 profile file 為基準讀取 epub.coverPath，只接受 PNG/JPEG；cover bytes 只放進 EPUB，不傳給 parser。--config 不再被 EPUB/DOCX 靜默忽略。

沒有 --config 時，CLI 依 front matter 選擇 built-in layout：writing-mode: vertical 使用 japanese-publisher 的 A4 landscape、右裝訂 40×30 小說原稿 grid；其他文件使用 word 的流動 A4 layout。只有明確提供的 --config 必須包含 layout.system。

profile 範例

{
  "layout": { "system": "japanese-publisher" },
  "metadata": { "title": "雨の東京", "author": "Illusions", "language": "ja" },
  "typesetting": { "writingMode": "vertical", "fontFamily": "Yu Mincho", "fontSize": 10, "textIndentEm": 1 },
  "pagination": { "pageSize": "A4", "landscape": true, "gridMode": "strict", "pageNumbers": { "enabled": true, "position": "bottom-center", "format": "simple" } },
  "epub": { "chapterSplitLevel": "h1", "coverPath": "cover.png" }
}

明確提供的 --config 必須含有 layout.system，缺少時 profile 會被拒絕。"japanese-publisher" 是書籍 system：橫書預設為 Shirokuban/10 pt 明朝體、鏡像左裝訂 27×26 strict grid；直書預設為 A4 landscape 小說原稿、鏡像右裝訂 40×30 strict grid。"word" 是另一個流動 system：A4、四邊 25.4 mm、無鏡像、gridMode: "typographic"，不能使用 strict grid。

MDI parse/diagnostic/span 的所有權在 Rust。profile 是 publication policy，而 PDF geometry 與 Chromium layout 是 host policy。PDF 需要 @illusions-lab/mdi-to-pdf 與 local Chromium；Chromium 收到的是完成 HTML，不是 .mdi。DOCX 支援 page/type/numbering，卻不保證 ruby、tate-chu-yoko、禁則/不換行、kern、blank paragraph 與 browser 排版像素一致，請在目標 reader 驗證。