Quarto HTML输出中{{< pagebreak >}}分页符不生效问题求助

问题原因 #

Quarto的{{< pagebreak >}}短代码仅对PDF/LaTeX、Word这类需要物理分页的输出格式生效，HTML属于流式布局，本身没有“分页”的原生概念，因此该短代码在HTML输出中会被直接忽略。

解决方案 #

根据你的需求场景选择对应的方法：

1. 视觉分隔内容（网页浏览时可见）

如果只是想在网页中区分不同章节的内容，使用Quarto支持的水平分割线即可：

---
title: "Untitled"
format: HTML
---

# Hello

***

# Goodbye

渲染后会显示一条水平横线，清晰分隔两个章节。

2. 打印时强制分页（仅打印/预览生效）

如果需要在打印HTML文档时实现强制分页效果，可以通过CSS来实现：

方法一：外部CSS文件（适合多页面复用）

1. 新建styles.css文件，添加打印分页样式：

@media print {
  .page-break {
    page-break-after: always;
  }
}

2. 在Quarto文档中引用该CSS并使用分页类：

---
title: "Untitled"
format: 
  html:
    css: styles.css
---

# Hello

<div class="page-break"></div>

# Goodbye

方法二：内联样式（快速实现单页面需求）

直接在需要分页的位置添加带内联样式的div：

---
title: "Untitled"
format: HTML
---

# Hello

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

# Goodbye

这种方式无需额外CSS文件，在打印预览或实际打印时，会在指定位置强制分页，网页浏览时无视觉变化。

内容的提问来源于stack exchange，提问作者Nicolás Sacco