Quarto PDF中为H1、H2标题配置Overpass字体差异化样式的技术咨询

我之前也踩过类似的Koma Script字体配置坑，结合你的需求，帮你整理了修复后的完整配置，同时拆解关键问题所在：

完整修复后的YAML配置 #

format:
  pdf:
    mainfont: Calibri
    sansfont: Overpass
    include-in-header:
      text: |
        \\usepackage{fontspec}
        % 定义带Extra Bold字重的Overpass字体命令
        \\newfontfamily\\overpassbold{Overpass}[
          BoldFont={Overpass Extra Bold},
          ItalicFont={Overpass Italic},
          BoldItalicFont={Overpass Extra Bold Italic}
        ]
        % 页眉页脚配置
        \\usepackage{fancyhdr}
        \\pagestyle{fancy}
        \\fancyhf{}
        \\rhead{\\includegraphics[width = .25\\textwidth]{logo.png}}
        \\cfoot{\\thepage}
        \\usepackage{float}
        % 自定义各层级标题的字体和字号
        \\setkomafont{chapter}{\\overpassbold\\fontsize{24pt}{28pt}\\selectfont}
        \\setkomafont{section}{\\overpassbold\\fontsize{18pt}{22pt}\\selectfont}
        \\setkomafont{subsection}{\\overpassbold\\fontsize{14pt}{18pt}\\selectfont}
standalone: false
toc: true
editor: visual
tbl-colwidths: auto

关键修改点说明 #

1. 合并重复的include-in-header
   你的原配置里有两个独立的include-in-header块，Quarto的YAML解析会直接覆盖前面的内容，导致你之前加的xltxtra和字体定义完全没生效——这是最容易忽略的坑！一定要把所有需要插入到页眉的LaTeX代码放在同一个include-in-header下。

2. 正确定义带字重的字体
   用fontspec（xltxtra已经包含它，不过直接调用更清晰）定义\\overpassbold命令时，要确保BoldFont的值和你系统中安装的Overpass Extra Bold字体的准确名称一致。比如Windows系统里字体名可能是Overpass Extra Bold，而Linux/Mac可能是Overpass-ExtraBold，可以通过系统字体管理器或fc-list | grep Overpass（Linux）确认。

3. 用\\setkomafont修改标题样式
   你之前用的\\usekomafont是用来调用已有的字体样式，而要修改chapter/section这类元素的字体，必须用\\setkomafont。同时可以直接在后面追加字号设置（\\fontsize{字号}{行高}\\selectfont），轻松实现不同层级标题的大小区分。

4. 备选简化写法
   如果不想单独定义\\overpassbold命令，也可以直接在setkomafont里指定字体：

   \\setkomafont{chapter}{\\fontspec{Overpass Extra Bold}\\fontsize{24pt}{28pt}\\selectfont}
   

   这种写法更直接，适合只在标题中用到Extra Bold字重的场景。

最后检查 #

如果还是报错，先确认你的系统已经正确安装了Overpass系列字体（尤其是Extra Bold版本）——字体找不到是这类问题的常见原因。

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