常见问题的解答——需要时，还有真人为你服务。
项目就是一个普通的文件夹（一个 .folio 包），其中包含以纯 Markdown 和 Typst 文件保存的文稿、以 .bib 文件保存的参考文献，以及一个记录活页夹结构的小文件 folio.json。没有任何内容藏在数据库里——你可以用任何编辑器打开这些文件、备份它们，或把它们移到任何地方。
首次启动时，选择新建项目（选一个模板和存放位置），或打开一个现有的 .folio 文件夹。在 iPhone 和 iPad 上，用项目选择器在 iCloud 云盘、“我的 iPhone”或任何已连接的“文件”位置中新建项目，或打开已在那里的项目。
把项目放在同步文件夹中——iCloud 云盘、Dropbox 或任何“文件”提供方——然后在每台设备上打开它。Folio Writer 就地读写这些文件，由云服务在设备之间传送。两台设备同时进行的编辑只要互不重叠，就会自动合并；真正冲突时，落败的那份副本会被保留（绝不丢弃），以便你找回。
这些是同步中的边界情况，最近的版本专门处理了它们。请确保每台设备都运行最新版本，然后让每台设备各打开一次项目，以便它看到其他设备的更改。如果问题依旧，请发邮件告诉我们你的系统版本以及所用的云服务。
不会。Folio Writer 没有服务器，也没有账户——你的文件始终保存在你自己的存储中。完整说明请参阅隐私政策。
把你的 .bib 文件放进项目的“参考文献”文件夹。按作者、年份或键插入引用；它们可以在编辑器中行内渲染，并在编译时解析为格式化的参考文献列表。支持组合引用和页码定位（[@smith2020, p. 33]）。
PDF、Word（.docx）、LaTeX、Typst、HTML 和 Markdown，通过 pandoc 和 Typst 生成——扉页、插图、交叉引用和参考文献都从你的纯文本源文件组装而成。
Folio Writer 运行在 Apple 的沙盒中，沙盒不允许直接启动外部程序。请安装免费的 Folio Helper——一款小型配套应用，它代表 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