LaTeX转RMD遇graphicx/geometry包冲突及YAML解析错误

一、graphicx/geometry包选项冲突错误 #

R Markdown编译PDF时，默认会自动加载graphicx、geometry等核心LaTeX包并设置基础选项，手动重复加载这些包且指定选项时就会触发冲突。

解决步骤：

• 无需手动在LaTeX代码块中加载graphicx或geometry，通过YAML配置传递所需选项：
  • 调整页面边距（geometry）：在YAML的pdf_document下使用latex_options

    output:
      pdf_document:
        latex_options: "geometry:margin=1in"
    

  • 若需自定义更多geometry选项，改用header-includes并确保格式正确：

    header-includes:
      - "\\usepackage[left=1.5in,right=1in,top=1in,bottom=1in]{geometry}"
    

  • 针对graphicx的需求（如图片分辨率），直接在YAML中设置fig.dpi参数，无需手动加载包：

    output:
      pdf_document:
        fig.dpi: 300
    

二、嵌入LaTeX代码时的YAML解析错误 #

YAML对冒号、反斜杠、特殊符号敏感，嵌入LaTeX代码时格式不当会触发解析失败。

解决方法：

1. YAML区域内添加LaTeX代码：
   • 使用竖线|保留代码的换行与格式，避免转义问题：

     header-includes:
       |
         \usepackage{booktabs}
         \newcommand{\highlight}[1]{\textbf{#1}}
     

   • 单行LaTeX代码需用引号包裹并转义反斜杠：

     header-includes:
       - "\\usepackage{amsmath}"
     

2. 正文区域嵌入LaTeX代码：
   • 行内公式用$...$包裹，行间公式用$$...$$包裹；
   • 非公式类LaTeX代码（如环境、命令）用代码块包裹：

     \begin{table}[h]
       \centering
       \begin{tabular}{cc}
         A & B \\
         \hline
         1 & 2 \\
       \end{tabular}
     \end{table}
     

   • 注意：所有LaTeX代码必须放在YAML头部（---之间的区域）之外。

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