R Markdown生成PDF时4、5级标题渲染后不换行该如何修复？

问题描述 #

使用R Markdown编写文档时，文档内设置的四级、五级层级标题，在渲染导出为PDF文件后，长文本无法触发自动换行，会出现内容溢出页面边距的异常排版效果，需要获取该问题的有效修复方法。

配套参考素材 #

• 生成对应PDF所用的R Markdown代码界面截图
• 代码运行后生成的实际PDF排版效果截图

有效修复方法 #

• 自定义LaTeX标题样式覆盖默认规则
  R Markdown 渲染PDF时默认调用LaTeX排版引擎，四级、五级标题在默认规则中对应\paragraph和\subparagraph样式，这两个样式默认采用行内布局，不支持自动换行。可以在文档YAML头的header-includes块中加入以下LaTeX配置，覆盖默认的标题排版定义：

  % 覆盖四级标题（\paragraph）为块级布局
  \titleformat{\paragraph}
    {\normalfont\normalsize\bfseries}{\theparagraph}{1em}{}
  \titlespacing*{\paragraph}
    {0pt}{3.25ex plus 1ex minus .2ex}{1.5ex plus .2ex}
  % 覆盖五级标题（\subparagraph）为块级布局
  \titleformat{\subparagraph}
    {\normalfont\normalsize\bfseries}{\thesubparagraph}{1em}{}
  \titlespacing*{\subparagraph}
    {0pt}{3.25ex plus 1ex minus .2ex}{1.5ex plus .2ex}
  

  配置完成后重新渲染文档，四级、五级标题会作为独立块级元素存在，长文本会自动适配页面边距完成换行。
• 批量适配方案：修改全局LaTeX模板
  如果需要在多个项目中统一处理该问题，可以在R Markdown的全局LaTeX模板路径下，修改对应标题层级的排版参数，将默认的行内布局替换为支持自动换行的块级布局，后续所有调用该模板生成的PDF都会自动适配标题换行规则，不需要逐文档添加配置。
• 临时手动调整方案
  对短周期使用的文档，可以在长标题需要换行的位置手动插入LaTeX强制换行命令\\，快速实现换行效果。该方案需要手动调整每个长标题，文档排版变动后需要重新匹配换行位置，仅适合短文档临时使用。

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