Quarto PDF全局样式设置求助：如何自动在一级标题前添加分页符

Quarto生成PDF依赖LaTeX引擎，无法用CSS的场景下，可通过YAML配置结合LaTeX命令实现全局样式定制，下面针对你提到的需求和常见场景给出具体方案：

1. 自动在一级标题前添加分页符 #

一级标题对应LaTeX中的section环境，借助titlesec包重定义标题格式，就能强制在每个一级标题前分页：

在文档开头的YAML头部添加以下配置：

title: "你的文档标题"
format:
  pdf:
    header-includes:
      - \usepackage{titlesec}
      - \titleformat{\section}[block]{\normalfont\Large\bfseries}{\thesection}{1em}{}[{\clearpage}]

• titlesec是LaTeX中用于自定义标题样式的工具包
• \clearpage命令会强制插入分页符，确保每个一级标题都从新页面开始

如果需要在二级标题前分页，只需把\section换成\subsection即可。

2. 其他全局样式的常见设置方式 #

字体与字号 #

直接通过Quarto的PDF格式选项配置：

format:
  pdf:
    mainfont: "SimSun"  # 中文宋体，英文可设为Arial等
    sansfont: "SimHei"
    fontsize: 12pt

行间距与段落间距 #

用LaTeX的setspace包调整：

format:
  pdf:
    header-includes:
      - \usepackage{setspace}
      - \onehalfspacing  # 1.5倍行间距
      - \setlength{\parskip}{0.5em}  # 段落间间距

页面边距 #

通过Quarto内置选项设置：

format:
  pdf:
    margin-left: 1.5in
    margin-right: 1.5in
    margin-top: 1in
    margin-bottom: 1in

核心思路总结 #

Quarto PDF的样式定制本质是对LaTeX功能的封装：

• 简单样式（如边距、基础字体）直接用Quarto提供的pdf格式选项即可
• 复杂自定义（如标题分页、特殊排版）通过header-includes引入LaTeX包和命令实现，你可以参考LaTeX的相关语法扩展更多样式。

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