如何避免Bookdown创建的EPUB电子书内章节标题被分页拆分或紧随标题后分页？

阿华AIGC实验室

2026-3-31

咱们先拆解你当前设置里的核心问题，再一步步修正解决：

1. 修复CSS文件的语法错误

你当前style.css的最后一行page-break-inside: avoid;是游离的，没有绑定到任何选择器，完全不会生效。咱们把标题的分页控制规则整合完整，替换成下面的代码：

p.caption {
  color: #777;
  margin-top: 10px;
}

p code {
  white-space: inherit;
}

pre {
  word-break: normal;
  word-wrap: normal;
}

pre code {
  white-space: inherit;
}

/* 标题分页控制：同时兼容新旧EPUB阅读器 */
h1, h2, h3, h4 {
  /* 避免标题后立即分页 */
  page-break-after: avoid;
  break-after: avoid;
  /* 避免标题本身被分页拆分 */
  page-break-inside: avoid;
  break-inside: avoid;
}

2. 确保EPUB正确加载自定义CSS

你在调用bookdown::render_book时设置了stylesheet = NULL，这直接覆盖了_output.yml里指定的style.css，导致你的自定义样式根本没被应用！

修正后的渲染代码可以删掉这个冲突参数，或者显式指定CSS路径：

bookdown::render_book(
  input = "index.Rmd",
  output_format = bookdown::epub_book(
    fig_width = 5, 
    fig_height = 4,
    dev = "png", 
    fig_caption = TRUE,
    number_sections = TRUE,
    toc = FALSE, 
    toc_depth = 2,
    # 删掉这行，或者改为 stylesheet = "style.css"
    # stylesheet = NULL,
    metadata = NULL, 
    chapter_level = 1,
    epub_version = c("epub3", "epub", "epub2"),
    md_extensions = NULL,
    pandoc_args = NULL, 
    template = "default"
  )
)

更省心的方式是直接依赖_output.yml的配置，把渲染代码简化成：

bookdown::render_book(input = "index.Rmd", output_format = "epub_book")

3. 可选：优化阅读器兼容性

部分小众EPUB阅读器对break属性支持不稳定，你可以给标题加上强制块级声明，再给段落加孤行控制：

/* 可选：避免段落首尾行单独分页 */
p {
  widows: 2;
  orphans: 2;
}

h1, h2, h3, h4 {
  display: block;
  page-break-after: avoid;
  page-break-inside: avoid;
  break-after: avoid;
  break-inside: avoid;
}