Pandoc项目：如何为Word文档中的参考文献添加编号

在学术写作中，规范的参考文献格式是论文质量的重要体现。使用Pandoc生成Word文档时，用户经常需要为参考文献列表添加编号。本文将深入探讨几种实现方法，帮助用户根据实际需求选择最佳方案。

方法一：使用数字引用风格的CSL文件

Pandoc通过citeproc处理参考文献时，CSL（Citation Style Language）文件决定了最终的呈现格式。数字编号风格（numeric）的CSL会为参考文献自动添加编号。

操作步骤：

1. 从Zotero样式库获取数字编号风格的CSL文件
2. 在Pandoc命令中通过--csl参数指定该文件
3. 生成的Word文档将自动包含编号的参考文献

注意：此方法会同时改变文中引用的格式（如变为上标数字），适合需要完整数字引用风格的场景。

方法二：自定义CSL文件实现混合风格

对于需要保持文中引用为"作者-日期"格式，但参考文献需要编号的特殊需求，可以通过修改CSL文件实现：

1. 在CSL文件中保留citation部分的作者-日期格式
2. 修改bibliography部分的layout节点，添加<text variable="citation-number"/>元素
3. 通过<group delimiter=". ">等设置控制编号与文献内容的间距

方法三：使用Lua过滤器处理输出

当上述方法不能满足格式要求时，Lua过滤器提供了更灵活的解决方案：

function Pandoc(doc)
    -- 将参考文献转换为有序列表
    -- 具体实现需要根据文档结构进行调整
end

将此过滤器保存为.lua文件，通过Pandoc的--lua-filter参数调用，可以将参考文献转换为Word能识别的有序列表格式。

高级技巧：Word样式定制

对于需要精细控制格式的场景，可以：

1. 准备包含自定义样式的Word参考文档
2. 在Pandoc命令中使用--reference-doc参数
3. 通过Lua过滤器或CSL为参考文献条目应用特定样式

这种方法特别适合需要符合特定出版格式要求的学术论文。

总结

Pandoc提供了多种为参考文献添加编号的途径，从简单的CSL文件替换到复杂的Lua过滤器，用户可以根据实际需求和技术水平选择合适的方法。对于大多数用户，从标准数字风格CSL文件开始尝试是最快捷的解决方案；当有特殊格式要求时，再考虑自定义CSL或Lua过滤器的方案。

记住在最终提交前，务必检查生成的Word文档是否符合目标期刊或机构的格式要求。