如何正确设置Rmarkdown渲染PDF，解决长行渲染后被截断问题

代码块内容溢出修复 #

• 全局配置代码自动换行：在文档初始的setup代码块中加入以下配置，自动格式化代码并折行，width.cutoff数值可根据页面宽度自行调整

  knitr::opts_chunk$set(tidy.opts = list(width.cutoff = 60), tidy = TRUE)
  

• 强制LaTeX代码环境折行：在YAML配置中加入header-includes参数，引入扩展包修改代码块默认规则，适配所有类型的代码格式

  output: pdf_document
  header-includes:
    - \usepackage{fvextra}
    - \DefineVerbatimEnvironment{Highlighting}{Verbatim}{breaklines,commandchars=\\\{\}}
  

• 调整R输出宽度：如果是代码运行的控制台输出结果溢出，在setup代码块中加入以下配置，缩小R默认输出的行宽

  options(width = 60)
  

普通文本/无格式长串溢出修复 #

• 无空格长串（如长ID、长链接）折行：引入seqsplit包强制无空格内容自动折行，使用时将长串放入对应命令即可
  1. 在header-includes中加：\usepackage{seqsplit}
  2. 正文内使用格式：\seqsplit{你的超长无空格字符串}
• 调整页面边距：如果是页面边距过大导致可用宽度不足，可在YAML中修改geometry参数缩小左右边距，数值可自定义

  geometry: "left=2cm,right=2cm,top=2cm,bottom=2cm"
  

• 手动折行：在需要折行的位置插入\break命令，强制在指定位置换行。

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