如何自定义Quarto PDF文档字体？mainfont、fontfamily及monofont相关咨询

基础配置方式 #

Quarto PDF 主要通过 mainfont、fontfamily、monofont 三个参数实现字体自定义，直接在文档的 YAML 头部配置即可：

1. 调用系统已安装字体（mainfont/monofont） #

如果目标字体已安装在你的系统中（比如 Windows 的「微软雅黑」、macOS 的「PingFang SC」），直接填写字体的准确名称：

---
title: "自定义字体演示"
format:
  pdf:
    mainfont: "PingFang SC"
    monofont: "Menlo"
---

2. 使用 LaTeX 字体包（fontfamily） #

fontfamily 对应 LaTeX 官方或第三方字体包，无需额外安装系统字体，直接指定包名即可，常用的字体包包括：

• cmbright：无衬线字体
• times：Times 系列衬线字体
• fourier：Fourier 数学字体包
  示例配置：

---
title: "LaTeX字体包演示"
format:
  pdf:
    fontfamily: "cmbright"
---

可用字体范围说明 #

mainfont 与 monofont 的可用范围 #

这两个参数支持系统中所有已安装的 TrueType/OpenType 字体，你可以通过以下方式确认可用字体：

• Windows：打开「控制面板 > 字体」查看字体的官方名称
• macOS：打开「字体册」应用查看字体名称
• Linux：终端执行 fc-list 命令列出所有可用字体

monofont 的可选范围 #

等宽字体的可选范围和 mainfont 一致，只要是系统中安装的等宽字体都可以指定，常见的选项有：Menlo、Consolas、Ubuntu Mono、Source Code Pro 等。

注意事项 #

• 若指定的字体不存在，Quarto 会自动切换到默认字体，不会抛出错误
• 若要使用非系统自带的字体，可将字体文件放在项目目录下，配合 fontpath 参数指定字体路径（需确保 LaTeX 支持该字体格式）

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