如何在Quarto中为整个PDF文档实现代码换行？

针对Quarto生成PDF时R代码长行超出页面的问题，有几种直接的解决方式：

1. 全局YAML配置（推荐） #

在Quarto文档的YAML头部，给pdf格式添加code-wrap: true配置，就能全局开启所有代码块的自动换行：

---
title: "你的文档标题"
format:
  pdf:
    code-wrap: true
    # 可添加其他PDF配置（如页码、字体等）
---

这个配置是Quarto 1.2及以上版本支持的，和你HTML用的code-overflow: wrap逻辑一致，属于官方原生支持的方案。

2. 单个代码块单独设置 #

如果只想让特定代码块换行，不需要全局生效，可以给目标代码块添加块选项#| code-wrap: true：

#| code-wrap: true
# 示例长行代码：
long_line_function <- function(input) { return(paste("这是一段用于测试自动换行的超长R代码，确保它不会超出PDF页面的右侧边界，同时保持代码的可读性", input)) }

3. 自定义LaTeX配置（兼容旧版Quarto） #

如果你的Quarto版本低于1.2，或者原生配置不生效，可以直接通过LaTeX的listings包（Quarto默认用它渲染代码）强制开启换行，在YAML里添加头部引入：

---
title: "你的文档标题"
format:
  pdf:
    include-in-header:
      text: |
        \usepackage{listings}
        \lstset{breaklines=true, breakatwhitespace=true}
---

breaklines=true开启自动换行，breakatwhitespace=true会优先在空格处换行，保证代码可读性。

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