Pandoc参考文献nocite参数配置不生效问题咨询

该问题是Pandoc 2.18版本内置citeproc模块的已知解析缺陷导致，具体触发逻辑如下：

• 通过命令行参数-M nocite='@*'传入的内容是纯字符串值，citeproc不会自动将其识别为引用通配指令，仅作为普通元数据文本处理，不会触发全量文献拉取逻辑
• 官方手册示例中的块式YAML写法nocite: |搭配换行写入@*，在2.18版本中存在兼容问题：块标量自带的尾部换行符会导致citeproc无法正确匹配@*通配规则，最终配置失效
• 该解析bug在Pandoc 2.19及后续稳定版本中已被官方修复，高版本不存在该问题。

按实施成本从低到高排序：

• 方案1：修正YAML头的nocite配置（无需升级，改动最小）
  弃用块式换行的nocite写法，改为行内字符串格式，和bibliography配置放在同一YAML层级，示例配置片段：

  ---
  # 其余原有YAML配置保持不变
  bibliography: main.bib
  nocite: '@*' # 不要加|换行符，直接写行内值
  ---
  

  修改后删除编译命令中冗余的-M nocite='@*'参数，重新执行编译即可正常输出bib文件中的全部参考文献条目。

• 方案2：升级Pandoc版本
  将本地Pandoc升级到2.19或更高的稳定版本，升级后无论是YAML块式写法、还是命令行-M传参的nocite配置，都可以被citeproc正常识别，不需要调整原有写法。

• 方案3：兜底兼容方案（不升级、不改YAML配置时使用）
  在文档参考文献章节的#refs容器上方，添加一个隐藏容器包裹显式的全量引用标记，强制citeproc拉取所有bib条目，示例代码片段：

  # References
  
  ::: {style="display: none"}
  [@*]
  :::
  
  ::: {#refs}
  :::
  

  外层容器设置为不渲染显示，不会对最终文档的排版效果产生影响，同时可以触发citeproc的全量文献加载逻辑。

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