我太懂这种分页符死活不生效的崩溃了！之前用Pandoc转HTML到DOCX的时候也踩过一堆坑，结合你的情况，给你几个实际可行的排查和解决方向：

针对Pandoc的解决方案 #

• 修复空块元素被忽略的问题
  你之前用的空<div style="page-break-after:always"></div>很可能被Pandoc优化掉了，因为空的块元素会被默认过滤。试试给div加个非断空格内容：

  <div style="page-break-after: always;">&nbsp;</div>
  

  这样Pandoc就会保留这个块，同时触发分页样式。

• 用DOCX模板样式的正确姿势
  如果你已经在模板里创建了带分页属性的段落样式（比如叫"break"），要注意两个关键点：

  1. 模板里的样式必须实际配置了分页属性：打开你的模板DOCX，找到"break"样式，右键修改，在「换行和分页」标签里勾选「段后分页」或「段前分页」，光命名没用哦。
  2. HTML里的类名要和模板样式名完全匹配（包括大小写），然后调用Pandoc的时候必须指定模板：

     pandoc -s input.html -o output.docx --reference-doc=your-template.docx
     

• 直接嵌入原生Word XML标签
  你试的那段Word原生XML其实有效，但要加上正确的命名空间，让Pandoc识别：

  <div xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
    <w:p><w:r><w:br w:type="page"/></w:r></w:p>
  </div>
  

  这样Pandoc会保留这段XML，生成DOCX时就会插入分页符。

针对PHP类库（比如PHPWord）的解决方案 #

PHPWord这类库确实经常有HTML和样式兼容的问题，试试这两个思路：

• 拆分HTML+原生分页符
  不要直接把整个HTML一次性导入，而是先把HTML拆分成多个部分（比如按你要分页的节点拆分），然后用PHPWord的原生方法插入分页符：

  // 初始化PHPWord和段落
  $phpWord = new \PhpOffice\PhpWord\PhpWord();
  $section = $phpWord->addSection();
  
  // 第一部分HTML
  $html1 = '<p>第一部分内容...</p>';
  \PhpOffice\PhpWord\Shared\Html::addHtml($section, $html1);
  
  // 插入分页符
  $section->addPageBreak();
  
  // 第二部分HTML
  $html2 = '<p>第二部分内容...</p>';
  \PhpOffice\PhpWord\Shared\Html::addHtml($section, $html2);
  

• 用自定义标记替换实现分页
  如果你不想手动拆分HTML，可以在HTML里加个自定义标记（比如<!-- PAGE_BREAK -->），然后用正则拆分HTML，循环导入并插入分页符：

  $fullHtml = '<p>内容1</p><!-- PAGE_BREAK --><p>内容2</p>';
  $htmlParts = preg_split('/<!-- PAGE_BREAK -->/', $fullHtml);
  
  foreach ($htmlParts as $index => $part) {
      if ($index > 0) {
          $section->addPageBreak();
      }
      \PhpOffice\PhpWord\Shared\Html::addHtml($section, $part);
  }
  

额外排查点 #

• 检查Pandoc命令有没有加-s（--standalone）参数，这个参数会生成完整的DOCX文档结构，有助于样式和特殊标签的解析。
• 如果你用的是Pandoc 3.2，确保你的CSS分页样式是标准的page-break-after: always，部分新版本对break-after: page的支持可能需要额外配置，但前者是稳的。

内容来源于stack exchange