pandoc转PDF报pandoccrossrefsubfigures未定义LaTeX错误如何解决

该报错本质为pandoc版本与pandoc-crossref版本不匹配、渲染参数缺失，或LaTeX环境缺少子图依赖宏包导致，可按以下步骤逐一排查修复：

• 首先校验版本匹配度
  pandoc与pandoc-crossref必须使用对应配套版本，你当前使用的pandoc 2.14.1需搭配同版本序列的pandoc-crossref。如果你通过Homebrew安装工具，可执行统一升级命令：
  brew upgrade pandoc pandoc-crossref
  也可手动下载pandoc-crossref对应2.14.1的官方二进制文件替换现有版本。
• 补全渲染命令的过滤器参数
  生成PDF时必须显式指定pandoc-crossref过滤器，且过滤器顺序需放在其他过滤器（如pandoc-citeproc）之前，命令示例如下：
  pandoc 你的输入文档.md --filter pandoc-crossref -o 输出文档.pdf
• 手动注入缺失的LaTeX环境定义
  如果版本匹配后仍报错，可在Markdown文档头部的YAML元数据块中添加如下配置，手动声明缺失的环境、加载子图依赖宏包：

  ---
  header-includes:
    - \usepackage{subfig}
    - \newenvironment{pandoccrossrefsubfigures}{}{}
  subfigGrid: false
  ---
  

  如果你的LaTeX环境未安装子图相关宏包，可先执行TeX包管理命令安装依赖：
  tlmgr install subfig subcaption

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