JOSS投稿GitHub Markdown论文引用配置及\cite失效问题

一、现有YAML配置的参考文献加载情况 #

你配置的bibliography: paper.bib字段本身符合JOSS的元数据要求，只要paper.bib和带YAML头的论文Markdown文件（JOSS要求命名为paper.md）存放在仓库同一根目录下，基础加载逻辑是成立的，但现有YAML存在3处会导致解析失败、连带引用失效的问题，必须修正：

• 第一位作者Simone Alessandri的名字末尾多了一个冗余的单引号，会触发YAML语法错误，导致整个元数据块无法被正常读取。
• equal-contrib字段赋值不符合规范：JOSS要求共同一作的该字段统一赋值为true即可，你当前给不同作者标注1/2/3这类序号的写法会被判定为格式错误，中断元数据解析。
• 配置中的aas-doi、aas-journal是天文期刊集群的专属字段，JOSS投稿不需要保留这类冗余字段，避免触发解析异常。
  修正以上问题后，paper.bib文件就能被正常加载。

二、正文参考文献正确引用方法 #

你之前使用的LaTeX格式\cite{uno}命令不被JOSS的Markdown渲染引擎（pandoc）支持，这是引用失效的核心原因，正确引用规则如下：

• 单篇文献引用：使用[@citekey]格式，比如要引用key为uno的文献，直接在正文对应位置写入[@uno]，渲染后会自动生成符合JOSS格式要求的带超链接引用标识。
• 多篇文献连续引用：将多个citekey用分号分隔放在同一组方括号内即可，例如[@uno; @second; @third]，渲染后会自动合并为连续引用标识。
• 若需要将作者名嵌入正文表述，可直接写@uno 的研究结果证实，渲染时会自动拼接作者名和对应引用标识。

注意不需要手动在正文末尾添加参考文献章节，渲染引擎会自动将所有已引用的BibTeX条目按规范排版在论文末尾。所有BibTeX条目的citekey建议只用英文字母、数字、下划线组合，不要加入特殊符号或中文，避免解析失败。提交前可以用JOSS官方提供的本地预览工具验证渲染效果，确认引用正常即可。

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