为何pandoc --citeproc无法解析Jupyter Notebook的参考文献引用？

1. 检查Notebook引用的基础格式 #

• 确认引用[@smid_development_2021]所在的是Markdown单元格，而非代码单元格
• 检查引用语法未被转义（比如是否变成\[@smid_development_2021\]）

2. 调整pandoc命令参数顺序 #

pandoc的参数顺序会影响功能生效，--citeproc需放在格式指定之后，正确命令示例：

# 转带引用的ipynb文件
pandoc lesson1.ipynb -f ipynb -t ipynb --bibliography bib.bib --csl ieee.csl --citeproc -o lesson1-withrefs.ipynb

# 转带引用的HTML文件
pandoc lesson1.ipynb -f ipynb -t html --bibliography bib.bib --csl ieee.csl --citeproc -o lesson1.html

原因：--citeproc是后置处理步骤，需在输入/输出格式、资源文件参数之后声明。

3. 验证bib文件条目合法性 #

打开bib.bib，确认目标引用条目无语法错误，比如：

@article{smid_development_2021,
  title = {Development of AES},
  author = {Smid, John},
  journal = {Cryptography Journal},
  year = {2021},
  volume = {5},
  pages = {123-145}
}

重点检查逗号、引号、括号是否匹配，字段名是否符合bibtex规范。

4. 升级pandoc版本 #

老版本pandoc对ipynb的citeproc支持存在缺陷，执行pandoc --version确认版本≥2.10，若版本过低则升级到最新稳定版。

5. 分步转换绕开ipynb直接处理的问题 #

如果上述方法无效，可通过中转Markdown文件实现引用解析：

# 先把ipynb转成带引用的Markdown
pandoc lesson1.ipynb -f ipynb -t md --bibliography bib.bib --csl ieee.csl --citeproc -o lesson1-refs.md

# 再把处理好的Markdown转回ipynb
pandoc lesson1-refs.md -f md -t ipynb -o lesson1-withrefs.ipynb

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