如何使用Pandoc为EPUB文档添加H2标题前分页符？

可能的原因及对应解决方案 #

1. 输出PDF时默认引擎不支持CSS分页规则 #

Pandoc默认用LaTeX生成PDF，此时CSS里的page-break-before规则不会生效。要让CSS分页逻辑起作用，需切换到支持CSS的PDF渲染引擎（比如wkhtmltopdf）：

• 先确保已安装wkhtmltopdf
• 执行Pandoc命令时指定引擎参数：

  pandoc --css=你的样式文件.css --pdf-engine=wkhtmltopdf 输入文件.md -o 输出文件.pdf
  

2. 输出HTML时样式被默认规则覆盖 #

如果输出的是HTML文件，可给H2的分页规则添加!important提升优先级，修改CSS为：

h1 { font-size: 120%; text-align: center;}
h2 {page-break-before: always !important; font-size: 120%; text-align: center;}

同时检查生成的HTML结构，确认H2没有被嵌套在会阻止分页的容器（如div、section）中；若存在嵌套，可针对容器补充规则：

section:has(h2) { page-break-before: always; }

3. 直接使用Pandoc原生分页指令 #

如果CSS方法仍不生效，可在Markdown文件的H2标题前添加Pandoc原生分页指令：

\newpage
## 你的H2标题内容

内容的提问来源于stack exchange，提问作者Jonathan Strange