Markdown 引用转 Word 后仍显示 [@key]？BibTeX 与参考文献排查指南

在 Markdown 中，[@smith2024] 这样的引用键便于写作和管理，但它不应该原样出现在最终 Word 文档里。如果 DOCX 仍然显示引用键，通常表示转换程序没有找到参考文献文件、引用键不匹配，或者没有获得正确的引用样式。

这并不是普通的字体或排版问题。引用转换需要同时正确关联三部分内容：Markdown 中的引用、BibTeX 或 CSL JSON 文件中的来源记录，以及最终使用的引用格式。任何一部分缺失或不一致，都可能导致引用键残留、参考文献内容不完整，甚至生成空白参考文献列表。

为什么 Word 中会残留原始引用键

Markdown 引用键只是一个标识符，并不是完整的参考文献。它的作用是告诉引用处理程序应该使用参考文献库中的哪一条记录。

已有研究也指出了相同限制 [@smith2024]。

转换程序会在参考文献文件中查找名称为 smith2024 的记录。找到后，再根据选择的引用样式生成正文引用和参考文献条目。

引用键原样保留通常有以下原因：

• 没有提供参考文献文件。
• Markdown 引用键与参考文献键不完全一致。
• BibTeX 或 CSL JSON 语法错误，或者文件编码异常。
• 引用位于代码块中，因此应按普通源码保留。
• 参考文献记录缺少当前样式要求的重要字段。
• 没有选择引用样式，或样式文件无法使用。
• 参考文献文件没有放进实际上传的 ZIP 中。

第一步：检查引用语法

普通括号引用可以写成：

该方法后来得到扩展 [@smith2024]。

作者作为句子组成部分时，可以写成：

@smith2024 认为原始方法仍需修订。

多个来源可以放在同一组引用中：

多项研究得出了相近结论 [@smith2024; @lee2025; @garcia2026]。

不要在引用键内部增加空格，也不要随意修改大小写、连字符或年份。引用键应被当作需要精确匹配的标识符。

第二步：确认引用键与参考文献记录一致

一条 BibTeX 记录由类型和引用键开始：

@article{smith2024,
  author  = {Smith, Jordan and Lee, Mei},
  title   = {Reliable Document Conversion Workflows},
  journal = {Journal of Technical Publishing},
  year    = {2024},
  volume  = {12},
  number  = {3},
  pages   = {44--58},
  doi     = {10.0000/example-doi}
}

Markdown 中的 [@smith2024] 对应左大括号之后的 smith2024。

第三步：把参考文献文件放进上传包

当 Markdown 和参考文献库是独立文件时，应放在同一个 ZIP 中。结构越简单，越容易检查：

research-report.zip
├── research-report.md
├── references.bib
└── images
    ├── workflow.png
    └── results-chart.png

使用 CSL JSON 时，将 references.bib 替换为对应 JSON 文件。不能把参考文献文件留在本地桌面，只上传 Markdown；在线转换服务无法读取未上传的本地文件。

第四步：转换前选择正确引用样式

相同来源记录在不同样式下会生成不同的正文引用和参考文献格式。作者—年份样式可能显示姓氏和年份，数字样式则可能显示方括号编号。

不要只根据个人视觉偏好选择格式。应使用期刊、学校、客户或内部规范明确要求的引用样式。

第五步：先检查元数据，再怀疑引用样式

引用样式只能排版已有数据。作者、年份、标题、期刊、出版社、页码、DOI 或 URL 缺失时，参考文献也会不完整。

根据来源类型，至少检查：

• 作者或机构名称
• 出版年份
• 标题
• 期刊、图书、会议或网站名称
• 卷、期和页码范围
• 出版社
• DOI 或稳定 URL
• 样式要求时使用的访问日期

不要把真实引用放在代码块里

代码块中的引用语法应按示例源码保留：

```markdown
引用语法示例：[@smith2024]
```

需要转换为真实引用时，把它放在代码围栏外：

已有研究评估了这一流程 [@smith2024]。

引用与脚注承担不同作用

引用用于标识外部来源；脚注用于补充说明、限定条件或额外背景。二者可以同时存在，但不能互相替代。

不要仅仅为了隐藏不完整引用而使用脚注。只要结论依赖外部来源，就仍需提供准确、完整的来源记录。

可靠的排查流程

1. 找到第一个原始引用键。记录准确拼写。
2. 搜索参考文献文件。确认存在完全相同的键。
3. 验证记录语法。检查大括号、逗号、引号、JSON 结构和编码。
4. 确认文件已经上传。打开 ZIP 并找到参考文献文件。
5. 检查引用位置。确认引用没有位于代码块中。
6. 选择要求的样式。使用收件方指定标准。
7. 建立最小测试。只保留一个引用和一条来源记录。
8. 把修正内容放回完整文档。再检查完整参考文献列表。

检查最终 DOCX

常见现象与处理方式

常见问题

最终检查清单