在浏览器里配置 Pandoc CSL 引用样式：APA、Chicago、Vancouver
Pandoc 能把满是裸引用键的文档变成带格式化引用和文献列表的成品：机制是 citeproc（新版已内置），样式用 CSL 描述，命令行与浏览器行为一致。
本文讲四件事：CSL 和样式文件从哪来；如何准备 BibTeX 文献库；同一输入在 APA、Chicago、Vancouver 下差在哪；哪些错误让成品留下字面引用键。
CSL 是什么
CSL 是一种 XML 格式，精确规定引用和文献条目的长相：年份放哪、题名是否斜体、页码怎么缩写。主流样式都有对应文件，Zotero 样式仓库收录数千种。
样式在文件里而不在代码里，切换规范只需换文件，不必改文档。期刊指定格式时通常点名样式，对应 .csl 文件可直接从仓库下载，无需配置。
citeproc 如何解析一条引用
源文档里引用用 at 符号内联书写：方括号里的键变成括号引用，写进句子的键变成叙事引用，作者名融入正文；页码等定位信息跟键写。
转换时 citeproc 按键到文献库查条目，交给 CSL 样式排版；同一遍收集所有被引条目，在文档末尾生成文献列表，或用 id 为 refs 的区块指定位置。键只是标签，出错才会进输出。
获取样式文件
样式仓库支持按出版商或关键词搜索，一键下载 .csl。注意样式名：Chicago 有生成脚注的 note-bibliography 变体，也有 author-date 变体，两者是不同文件。
期刊只给格式说明时，先在 Zotero 样式仓库搜期刊名。它跟踪数千种期刊，维护中的文件好过手工改的；实在没有，选最接近的母样式，草稿够用。
准备 .bib 文献库
文献库把键映射到元数据。BibTeX 记录以类型开头，如 article 或 book，接着是你起的键，再是 author、title、year、journal、DOI 等字段。键是正文里要敲的，短而好记，命名方案保持稳定。
字段完整度直接反映在输出上：缺年份，APA 引用留空位；缺 DOI，读者要点的链接就没了。专有名词用双层大括号包在 title 里可保护大小写，否则 BibTeX 可能按规则把题名转小写。
同一输入，三种输出
取一行含方括号键和叙事键的原文。APA（author-date）下，方括号引用变成括号内姓名加年份，叙事引用变成作者名加括号年份，文献按字母排序；Chicago 的 note-bibliography 变体则输出编号脚注，首引完整、后引简写。
Vancouver 是医学界常用样式，引用变成按首次出现顺序编号的方括号数字。三种版本间正文一字不改：键、文献库、文档原样，只换 CSL 文件。
在浏览器里跑引用处理
本站 Pro 引用选项接受两个上传：装参考文献的 .bib 和装样式的 .csl。处理全在浏览器 worker 里完成，citeproc 就是转换引擎的一部分，解析结果与命令行一致。
流程很短：照常写带 at 键的文档，每项目一个 .bib，放入目标期刊要的样式文件再转换。换期刊只需换传 .csl，不用重写引用。
常见错误与排查
最高频的失败是键不匹配：正文引用的键在 .bib 里没定义，Pandoc 会把原始方括号文本留在输出里，并记录找不到引用的警告；检查拼写，确认上传的是想用的文件。
大小写问题出在 title 字段：样式要求时缩写和专名会被转小写，双层大括号保护就是为此存在的。字段缺失表现为空白或残缺引用，投稿前抽查一条渲染后的文献条目即可。
浏览器输出与命令行对比
浏览器版跑同一个 citeproc 实现，嵌在同一个 Pandoc 引擎里。输入相同、版本相同时，排版后的引用和文献列表与命令行产出一致。
这种等价性让浏览器成为准备投稿初稿的正经场所。本站的 .bib 与 .csl 处理全程留在浏览器里，未发表的手稿不离开你的机器。