Quarto导出PDF时LaTeX方程组无法正常渲染如何解决？

问题根源 #

Quarto渲染PDF依赖本地LaTeX引擎（而非HTML/VS Code预览用的MathJax），因此MathJax的配置不影响PDF输出，问题大概率出在LaTeX环境的包支持或引擎配置上。

具体解决步骤 #

• 确保LaTeX环境安装了amsmath包：cases环境属于amsmath宏包，若本地TeX发行版（如TeX Live、MikTeX）未安装该包，会导致方程组无法渲染。可通过TeX发行版的包管理器手动安装amsmath，或设置MikTeX自动安装缺失包。
• 指定LaTeX引擎并配置宏包：在文档开头的YAML配置中，指定支持复杂数学渲染的引擎（如XeLaTeX或LuaLaTeX），并显式引入amsmath包：

  ---
  title: "你的文档标题"
  format:
    pdf:
      engine: xelatex
      include-in-header:
        text: |
          \usepackage{amsmath}
  ---
  

• 调整LaTeX语法格式：尝试用标准LaTeX行间数学环境\[...\]代替Markdown风格的$$...$$，避免渲染引擎识别异常：

  \[
  \begin{cases}
    \frac{\partial u}{\partial t}=a^2\frac{\partial^2 u}{\partial x^2}+2x,\;0<x<1\\
    u|_{x=0}=-2\\ u|_{x=1}=-1\\ u|_{t=0}=x-2
  \end{cases}
  \]
  

• 检查TeX发行版完整性：若使用TeX Live，建议安装full版本；若用MikTeX，确保开启“自动安装缺失的包”选项，避免因依赖缺失导致渲染失败。

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