常見問題的解答——需要時，還有真人為你服務。
專案就是一個普通的資料夾（一個 .folio 套件），裡面以純 Markdown 與 Typst 檔案存放你的文稿，以 .bib 檔案存放你的參考文獻，再加上一個記錄活頁夾結構的小檔案 folio.json。沒有任何東西藏在資料庫裡——你可以用任何編輯器開啟這些檔案、備份它們，或把它們搬到任何地方。
首次啟動時，選擇新建專案（選取模板與位置），或開啟現有的 .folio 資料夾。在 iPhone 和 iPad 上，可用專案選擇器在 iCloud Drive、「我的 iPhone」或任何已連接的「檔案」位置中建立專案，或開啟已經在那裡的專案。
把專案放在會同步的資料夾中——iCloud Drive、Dropbox 或任何「檔案」提供者——然後在每台裝置上開啟它。Folio Writer 直接就地讀寫檔案；在機器之間搬運檔案則交給雲端服務。兩台裝置同時進行的編輯只要不重疊，就會自動合併；真正發生衝突時，落敗的那份副本會被保留（絕不丟棄），讓你可以把它找回來。
這些是同步的邊緣情況，近期版本已專門處理。請確認每台裝置都在執行最新版本，再讓每台裝置各開啟一次專案，以便看到其他裝置的變更。如果問題仍然存在，請寫信給我們，並附上你的作業系統版本以及所使用的雲端服務。
不會。Folio Writer 沒有伺服器，也沒有帳戶——你的檔案留在你自己的儲存空間中。完整說明請見隱私政策。
把你的 .bib 檔案放進專案的「參考文獻」資料夾。依作者、年份或鍵插入引用；它們可以在編輯器中即時渲染，並在編譯時解析成格式化的參考文獻列表。也支援群組引用與頁碼定位（[@smith2020, p. 33]）。
透過 pandoc 與 Typst，可編譯成 PDF、Word（.docx）、LaTeX、Typst、HTML 與 Markdown——標題頁、圖表、交叉引用與參考文獻都從你的純文字原始檔組裝而成。
Folio Writer 在 Apple 的沙盒中執行，沙盒不允許直接啟動外部程式。請安裝免費的 Folio Helper——這是一款小型輔助 App，會代替 Folio Writer 執行你 Mac 上已安裝的排版工具（pandoc、pandoc-crossref、LaTeX、Typst、Quarto）。把它放進「應用程式」並開啟一次後，編譯 ▸ 設定外部工具…就會列出它找到的每一個工具。
還沒有這些工具？在「終端機」中用一行指令安裝——它會顯示一個選單，讓你挑選 pandoc、pandoc-crossref、Quarto、Typst 以及 LaTeX 引擎：
curl -fsSL https://foliowriter.app/install-folio-tools.sh | bash
開啟編譯 ▸ 設定外部工具…並按下重新檢查——面板會列出 Folio Helper 能看到的工具，連同路徑與版本，對仍然失敗的項目還有「複製診斷資訊」按鈕。以 Homebrew、MacTeX 或 TinyTeX 安裝的工具會被自動找到。如果某個引用無法解析，請確認該鍵確實存在於你的某個 .bib 檔案中。
開啟同樣的專案、用 Markdown 按鍵列編輯、瀏覽並重新整理活頁夾、拍攝與還原快照、跨文稿搜尋、插入引用，以及預覽渲染後的文稿（含數學公式）。編譯成 PDF/Word 仍在 Mac 上進行，因為那些工具只能在桌面電腦上執行——但你寫下的一切都會直接同步回去。
那是 iCloud 正在把檔案下載到本機。網路連線良好時通常片刻就會解決；如果卡住了，請在「檔案」App 中開啟同一個資料夾以推動下載，然後再回到 Folio Writer。
使用聯絡表單，附上簡短說明、你的作業系統版本，以及——若是錯誤——觸發它的步驟。功能建議都會被認真閱讀，並影響接下來要打造的東西。
Folio Writer