Folio Writer

一部手稿,四種引擎:
Markdown、pandoc、Quarto 與 Typst

大多數寫作工具要你選定一種格式,然後接受它的輸出。Folio Writer 把這兩個決定分開:你只需用純文字寫一次,每次編譯時再選擇渲染引擎——因為學位論文委員會、期刊和預印本伺服器很少要的是同一樣東西。

編譯面板:每次編譯各自選擇格式與渲染器。
編譯面板:每次編譯各自選擇格式與渲染器。

Markdown:唯一的真實來源

Folio Writer 專案中的每一份一般文稿都是純 .md 檔案——pandoc 風格的 Markdown,附帶真正重要的學術擴充語法:[@citations]、$math$、註腳、管線表格與網格表格、@fig:/@tbl:/@eq: 交叉引用、任務清單、Wiki 連結。編輯器會即時渲染——帶樣式的標題、排版好的數學公式、解析完成的引用——但檔案始終是你能用 grep 搜尋、用 diff 比對、到 2040 年還能開啟的文字。下面介紹的一切都不會改變這一點:這些引擎是輸出的選擇,而不是檔案格式。

pandoc:萬用翻譯機

預設的流程。編譯會把你的活頁夾縫合成一份文件,交給 pandoc,由它產生 Word (.docx)、OpenDocument (.odt)、LaTeX (.tex)、HTML、EPUB——若有 TeX 發行版,還能透過 xelatex、pdflatex、lualatex 或 tectonic 產生期刊經典風格的 PDF。引用由 citeproc 依任何 CSL 樣式格式化;pandoc-crossref 為你的圖、表與公式編號。Folio Writer 也能匯出縫合好、自成一體的 .md——pandoc manuscript.md -o out.pdf --citeproc 就能在任何地方重現你的建置結果,而這正是純文字的意義所在。

Quarto:期刊與可執行程式碼

把渲染器切換為 Quarto,就會開啟兩扇門。第一,完全符合出版社要求的輸出(請參閱期刊投稿指南):加入期刊擴充套件(AGU、Elsevier、Copernicus…),設定一行中繼資料(quarto-to: agu-pdf),然後編譯——Folio Writer 會把你結構化的作者與所屬機構資訊原樣傳遞給期刊模板使用,並移除會與期刊文件類別衝突的通用版面設定鍵。第二,可執行的手稿:{python} 與 {r} 程式碼區塊會在編譯時執行,因此每次建置時圖表都會從你的資料重新產生(請參閱動態繪圖)。到處都寫 @fig:xrd 即可——Folio Writer 會自動轉換成 Quarto 原生的連字號語法,兩種渲染器共用一套語法。

Typst:快速的現代排版器

Typst 就是 LaTeX 如果在今天設計會有的樣子:不到一秒就能產生 LaTeX 等級的 PDF,而且不需要 TeX 發行版——Typst 只是一個小小的單一執行檔(brew install typst),是目前通往排版 PDF 最輕量的途徑。Folio Writer 會把你的 Markdown 手稿轉換為 Typst 原始碼(包含引用、交叉引用、編號與目錄)並編譯;你也可以直接匯出 .typ,再用 typst watch 手動微調。除了轉換之外,Typst 也是一等公民的文稿類型:在活頁夾中建立原生 .typ 文稿——自訂表格、精確的圖片位置、#show 規則——並與 Markdown 章節混用於同一個專案中,一起編譯。

什麼時候用哪種引擎?

你需要使用
給論文委員會或共同作者的 Word 檔案pandoc → .docx(支援追蹤修訂)
給 LibreOffice/OpenOffice 的 OpenDocumentpandoc → .odt(數學公式為原生 ODF 公式)
設定最少、成品漂亮的 PDFTypst 渲染器(brew install typst——不需要 TeX)
完全符合期刊要求的投稿(AGU、Elsevier…)Quarto + 期刊擴充套件
編譯時從資料產生的圖表Quarto + {python}/{r} 程式碼區塊
給投稿系統的 LaTeX 原始碼pandoc 或 Quarto → .tex
親手精確控制排版原生 .typ 文稿/.typ 匯出
工具說明:App Store 版本處於沙盒中,因此外部工具——pandoc、pandoc-crossref、TeX 發行版、Quarto——包括 Typst——都透過免費的 Folio Helper 執行;它只執行一份固定的允許清單,而且只在 Folio Writer 要求時才執行。Typst 是其中最輕量的:單一執行檔,不需要 TeX 發行版。即時預覽則完全不需要任何工具——它能自行離線排版文字、數學公式與引用。

一以貫之

四種引擎,一個原則:手稿永遠不屬於渲染器。同一個裝滿純文字檔案的資料夾,可以在週一產出給論文委員會的 Word 文件、週三產出給期刊的 LaTeX、週五產出以 Typst 排版的預印本——就算哪天你離開了 Folio Writer,這些檔案每一個都依然能開啟、能閱讀、能編譯。

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