本文详细讲解了如何在Scrivener中规范、可靠地将写作项目编译为符合国际标准的ePub电子书，涵盖从结构梳理、格式配置、HTML/CSS映射、封面嵌入到最终验证的全流程五步法，并特别强调避开常见陷阱（如悬浮文档、标题未设、封面未嵌入、元数据缺失等），确保导出的ePub文件能在Kindle、Apple Books等主流阅读器中完美显示目录、样式与跳转功能——无论你是首次尝试出版电子书的新手，还是追求专业交付质量的创作者，这篇实操指南都能帮你一步到位生成可商用的高质量ePub。

如果您在Scrivener中完成了文档写作，希望将其导出为标准ePub格式以便在Kindle、Apple Books或其他阅读器中使用，则需通过内置的“编译”功能进行结构化输出。以下是将Scrivener项目编译为ePub电子书的具体操作路径与关键设置说明：

一、确认项目结构符合ePub规范

ePub要求内容具有清晰的层级结构，包括封面、标题页、目录、正文章节及元数据。Scrivener依赖文件夹与文档的嵌套关系生成逻辑目录树。若项目中存在未命名的空白文档、孤立的文本块或未分配到任何文件夹的根级文档，可能导致编译后章节缺失或顺序错乱。

1、在“Binder”面板中检查所有文档是否归属至明确的文件夹（如“封面”“前言”“第1章”等），避免出现悬浮于根目录的独立.rtf或.txt文档。

2、右键点击各章节文档 → 选择“Document Settings…” → 在“General”标签页中确认“Title”字段已填写有效名称，该名称将作为ePub中章节标题显示。

3、确保“封面”文档被标记为封面：选中该文档 → 点击菜单栏“Project” → “Set Compile Format…” → 勾选“Use as cover page”选项。

二、配置ePub专用编译格式

Scrivener默认编译格式不直接支持ePub元数据嵌入与语义化标签生成，必须切换至预设的ePub导出模板，以启用CSS样式控制、NCX目录生成及OPF元信息填充功能。

1、点击工具栏“Compile”按钮（或按快捷键⌘K / Ctrl+K）。

2、在弹出窗口左下角点击“Format As:”下拉菜单 → 选择“ePub (for eBook readers)”。

3、点击右侧“Options…”按钮 → 在新窗口中勾选“Include table of contents”和“Generate NCX file”，确保阅读器可识别导航结构。

4、切换至“Metadata”标签页 → 手动输入“Author”“Title”“Publisher”及“ISBN”（如适用），这些字段将写入ePub的OPF文件中。

三、调整内容过滤与格式映射

ePub不支持Scrivener原生格式中的部分排版指令（如段前缩进、多级编号列表样式），需通过“Formatting”面板将文档样式映射为标准HTML/CSS规则，否则导出后可能出现字体异常、段落粘连或列表符号丢失。

1、在“Compile”窗口中点击“Formatting”标签页 → 取消勾选“Compile group folders as separate documents”，防止文件夹被误转为独立HTML文件。

2、展开“Text Formatting”区域 → 将“Heading 1”映射为“

”，“Heading 2”映射为“

”，以此类推；正文段落统一映射为“

”并启用“Preserve line breaks in text”。

3、点击“Edit CSS…”按钮 → 在弹出编辑框中添加以下基础样式以适配多数阅读器：p { margin-top: 0.5em; margin-bottom: 0.5em; text-align: justify; }，然后点击“OK”保存。

四、插入自定义封面图像

ePub规范要求封面必须为嵌入式图像资源（通常为JPG或PNG），且需在content.opf与guide.xml中正确声明路径。Scrivener仅支持自动嵌入单张封面图，但要求图像文件已作为文档附件存在于项目内，而非仅链接外部路径。

1、将封面图片文件（建议尺寸1600×2560像素，RGB模式，小于500KB）拖入Binder顶部“Research”文件夹或任意子文件夹中。

2、返回“Compile”窗口 → 点击“Cover”标签页 → 点击“Choose Cover Image…” → 从项目内部附件列表中选取该图片文件。

3、勾选“Embed cover image in ePub”选项 → 确保“Cover image format”设为“JPEG”或“PNG”，不可选“Auto”。

五、执行编译并验证输出文件

Scrivener生成的ePub文件需经实际阅读器加载测试，因不同设备对CSS兼容性、字体嵌入策略及SVG支持程度差异较大，未经验证的输出可能在翻页时出现空白页、图片错位或目录跳转失效。

1、在“Compile”窗口底部点击“Compile”按钮 → 设置保存位置与文件名（扩展名自动设为.epub）。

2、导出完成后，使用Calibre打开该ePub文件 → 点击“T”图标（Table of Contents）检查章节层级是否完整，点击任一项验证跳转是否准确。

3、右键文件 → “View files in ePub” → 展开OEBPS文件夹 → 查看cover.xhtml是否存在且引用路径正确，确认toc.ncx与content.opf中

到这里，我们也就讲完了《Scrivener制作ePub教程详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于Scrivener的知识点！