RMarkdown生成PDF时添加带Logo的自定义信头方案及报错解决

• 触发Missing \begin{document}的本质是LaTeX解析顺序错位：自定义的fancyhdr、tikz相关配置本该放在文档导言区（也就是\begin{document}命令之前），但被RMarkdown错误传递到了正文区，导致解析器在遇到导言区专属命令时，还没检测到\begin{document}标记，直接抛出错误。
• 常见触发场景：把自定义LaTeX代码直接写在Rmd正文的{=latex}围栏块里，没有通过YAML的header-includes通道传递到导言区。

直接把以下内容替换到对应Rmd的YAML块中，完全适配article文档类、pdf_document输出要求，支持logo嵌入、自定义文字内容和颜色：

---
title: 报告标题
documentclass: article
output:
  pdf_document:
    latex_engine: xelatex
    keep_tex: true
header-includes:
  # 基础依赖宏包加载
  - \usepackage{fancyhdr}
  - \usepackage{graphicx}
  - \usepackage{xcolor}
  - \usepackage{tikz}
  - \usepackage{geometry}
  # 信头可配置参数块
  - \definecolor{headerPrimary}{HTML}{165DFF} # 自定义信头主色，可替换为任意色值
  - \newcommand{\logoPath}{./logo.png} # 替换为本地logo文件路径
  - \newcommand{\headerMainText}{你的单位/团队名称} # 自定义信头主文字
  - \newcommand{\headerSubText}{部门信息 | 联系方式} # 自定义信头副文字
  # 页眉样式配置
  - \geometry{margin=1in, top=3cm} # 预留信头占用的顶部空间，避免压正文
  - \pagestyle{fancy}
  - \fancyhf{}
  - \renewcommand{\headrulewidth}{0pt} # 移除fancyhdr默认的页眉分隔线
  - \fancyhead[L]{
      \begin{tikzpicture}[remember picture,overlay]
        # 绘制信头通栏色带
        \fill[headerPrimary] (current page.north west) rectangle ([yshift=-2cm]current page.north east);
        # 左侧嵌入logo
        \node[anchor=north west, xshift=1cm, yshift=0.4cm] at (current page.north west) {\includegraphics[height=1.2cm]{\logoPath}};
        # 右侧放置信头文字
        \node[anchor=north east, xshift=-1cm, yshift=0.3cm, text=white, align=right] at (current page.north east) {
          \large \bfseries \headerMainText \\
          \small \headerSubText
        };
      \end{tikzpicture}
    }
---

• 配置完成后如果还是报错，打开YAML配置里keep_tex=true生成的中间.tex文件，检查所有自定义LaTeX命令是否全部位于\begin{document}行之前：如果发现代码跑到\begin{document}后面，说明代码放置位置错误，需要移回YAML的header-includes区域。
• 检查宏包加载顺序：必须先加载xcolor宏包再执行颜色定义，先加载tikz宏包再使用tikzpicture环境，顺序颠倒会触发连带的导言区解析错误。
• 如果不需要通栏色带效果，直接注释掉色带填充的那行tikz代码，把信头文字的颜色从white改成headerPrimary，即可切换为白底文字的简约信头样式。

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