scrivener导出epub需五步：一、规范项目结构，确保文档归属文件夹并设好标题与封面；二、选用“epub (for ebook readers)”编译格式，配置目录、ncx及元数据；三、映射标题与正文为html标签，添加适配css；四、嵌入项目内封面图并指定格式；五、用calibre验证目录跳转、文件结构及元数据一致性。
如果您在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中
