求助：Quarto Markdown中{{< pagebreak >}}分页符无法生效

• 确认输出格式匹配：{{< pagebreak >}} 仅对PDF、Word、EPUB这类需要物理分页的输出格式生效，HTML输出默认不会渲染该分页符。如果是HTML场景，改用CSS实现分页：

  .page-break {
    page-break-after: always;
  }
  

  之后在文档中用 <div class="page-break"></div> 替代原短代码。

• 升级Quarto版本：旧版本可能存在短代码兼容bug，执行命令升级到最新稳定版：

  quarto upgrade
  

• 核对短代码语法：确保没有拼写或格式错误，正确写法是{{< pagebreak >}}，不要写成{{ pagebreak }}或添加多余空格。

• PDF输出额外排查：若目标是PDF，可在文档开头添加YAML配置强制保留中间LaTeX文件，验证分页命令是否被正确插入：

  format:
    pdf:
      keep-tex: true
  

  生成后查看.tex文件，确认是否存在\newpage（Quarto会自动将pagebreak转换为该LaTeX命令）。

• Word输出检查：生成Word文档后，开启“显示/隐藏编辑标记”，确认分页符是否被正确插入；若未生效，检查文档段落格式是否覆盖了分页设置。

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