Folio Writer

圖、公式與交叉引用

手工編號是圖表引用出錯的根源。在 Folio Writer 裡,你只給物件加一次標籤、按名字引用,編譯負責全部編號——編輯器則就地顯示圖片、題注和排版好的公式。

標籤

圖就是獨佔一行的普通 Markdown 圖片,再在花括號里加標籤:

![MgO 的壓縮曲線](Research/compression.png){#fig:compression width=70%}

替代文字就是題注。width= 接受文字寬度的百分比或絕對尺寸(3in、8cm、400px),在 PDF、Word 和 HTML 中同樣生效。表格的標籤寫在表格下方的題注行裡:

| 相 | P (GPa) |
|----|---------|
| B1 | 0–400   |

: MgO 的各相 {#tbl:phases}

公式是行間數學後面跟上標籤:

$$K_T = -V \left(\frac{\partial P}{\partial V}\right)_T$$ {#eq:bulk}

引用

用 @ 加鍵名引用任何已加標籤的物件——@fig:compression、@tbl:phases、@eq:bulk——編譯會列印“Fig. 1”“Table 1”“eq. 1”。句首把字首大寫(@Fig:compression);多個一起引用寫成 [@fig:a; @fig:b]。編號按整部手稿中的出現順序排列,所以在活頁夾裡移動一章也會正確地重新編號。

編號由 pandoc-crossref 完成:在 Mac 上它與其他工具一起安裝(編譯 ▸ 設定外部工具…),Folio Writer 伺服器也已內建,因此從 iPhone、iPad 編譯的編號方式完全一致。沒有它,引用會按原樣列印。

編輯器中看到的

開啟渲染圖片後,獨佔一行的圖片會直接顯示為圖片,尺寸與匯出一致,題注與 [fig:key] 標籤顯示在下方。公式就地排版——行內公式落在正文自己的基線上,行間公式獨佔一行並在旁邊帶有 (eq:key) 標記。上下標(H~2~O、x^2^)顯示為 H₂O 和 x²。游標一進入該段落,Markdown 就會回到眼前,編輯從不盲目;點按渲染好的圖片即可開啟原始碼。

在 iOS 上這些位於 設定 ▸ 編輯器 ▸ 渲染(圖片、公式、上下標,以及隱藏多少 Markdown 語法);在 Mac 上位於 設定 ▸ 編輯器。檔案本身始終是純文字。

插入圖片

把圖片檔案拖進編輯器、貼上,或使用 插入 ▸ 圖片:檔案會被複制到專案的 Research 資料夾,Markdown 自動寫好,標籤可隨時修改。路徑保持相對於專案,手稿在哪裡都能編譯。

參考文獻列表

交叉引用不是文獻引用:@fig:x 在參考文獻處理之前就被解析,所以永遠不會去查詢名為“fig:x”的文獻鍵。當手稿確實引用了文獻,編譯結果末尾會有一節 References;想自己安排位置,在草稿任意處寫

# References {.unnumbered}

::: {#refs}
:::

格式化的列表就會填入該塊。

SVG 與 PDF 插圖。Typst 和 HTML 預覽直接讀取 SVG;LaTeX 路線會把 SVG 柵格化,PDF 插圖則原樣使用。用於印刷時,PDF 或 300 dpi 的 PNG 最穩妥。

免費下載 Folio Writer →  ·  更多指南