在markdown、pandoc(.md后缀)、quarto(.qmd后缀)、R Markdown(.rmd后缀)、MDX(.mdx后缀)以及latex文件的编写过程中,如果想要实现类似ms word文件的编辑过程,边插入边更新bib文件。或者想将当前文件的key列表,导出最终的bib文件,那么该插件就非常适合你。
自动融合远程 Pull Requests
项目里新增了一个自动合并脚本,可按顺序抓取并合并远程 PR 引用到当前分支。
前提条件:
- 当前目录是 git 仓库。
- 远程仓库暴露 PR 引用(默认使用
refs/pull/*/head,GitHub/Gitee 常见)。
- 建议在工作区干净(无未提交变更)时运行。
常用命令:
# 仅预览将要合并的 PR,不执行 merge
npm run sync:prs:dry
# 实际执行自动合并
npm run sync:prs
# 指定远程并限制最多合并 5 个 PR
npm run sync:prs -- --remote upstream --limit 5
冲突处理:
- 当某个 PR 合并冲突时,脚本会尝试执行
git merge --abort 保持工作区整洁。
- 默认遇到冲突即停止;如需继续处理后续 PR,可加
--keep-going。
issue与代码提交
由于本人不经常使用latex以及markdown,只在写论文的时候才会用,如果您喜欢使用该插件,但对其中的一些细节有额外的需求,您可以写issue,另外对于本身有一些编程能力的用户,非常欢迎提交自己的代码(请您务必认真自己测试提交的代码!因为我实在有点懒惰,不会仔细review代码)。
插件功能
- Zotero Cite: Export BibLatex
查询当前编辑的markdown、pandoc或者latex文档,根据引用的key,导出引用至bib文件。

- Zotero Cite: Add Citation for Pandoc/Latex
如果你想在pandoc以及latex文档的书写过程中,希望插入citation,但是不想更新bib文件,那么这个功能比较适合你。

- Zotero Cite: Cite and Create Bibliography for Pandoc/LaTeX
如果你想在pandoc以及latex文档的书写过程中,希望插入citation的同时更新bib文件,那么这个功能比较适合你。

- Zotero Cite: Cite and Create Bibliography for Markdown
如果你想在markdown / quarto(.qmd)/ R Markdown(.rmd)/ MDX(.mdx)文档的书写过程中,希望插入citation的同时更新脚注,那么这个功能比较适合你。

- Zotero Cite: Cite Hyperlink

- Zotero Cite: Zotero Cite: Update BibTex Entries
从 Zotero 更新 defaultBibName 路径对应bib文件的所有项,存在未匹配项则不修改原始记录。
插件配置项
- zotero-cite.defaultBibName:导出引用文件的默认路径。默认值为
ref.bib。可以使用通配符:${workspaceFolder}、${fileBasename}、${fileBasenameNoExtension}、${fileDirname}、${fileExtname}。
- zotero-cite.latexBibStyle:导出的LaTeX引用格式,应为
bibtex或biblatex。默认值为bibtex。
- zotero-cite.showMarkdownCitationHoverPreview:是否显示 Markdown 中
[^key] 与 @key 的 hover 预览。默认值为 true。
- zotero-cite.showMarkdownCitationCompletion:是否显示 Markdown 中
[^ 与 @ 的引用建议列表。默认值为 true。
修改历史
- 2021-11-01:创建了zotero-export插件并增加了文件名输入的功能。增加when支持,只允许在markdown或者latex环境下激发命令。
- 2021-11-02:将zotero-export插件更名为export-cite,优化bibliography导出到文件的功能,使其支持latex环境。同时添加了
zotero-cite.citeBibliography以及zotero-cite.citeMarkdownBibliography两个命令,使其可以在插入引用的同时,将bibliography插入到默认的文件中。
- 2022-02-06: 对zotero-cite进行了全面的修改,使其可以支持markdown、pandoc以及latex环境的引用插入。可以智能的识别当前鼠标的位置是否在引用环境中,从而决定是应该直接插入,还是采用新增的方式插入引用。
- 2022-02-07:优化pandoc以及latex文件的插入引用函数,消耗资源更少。
- 2022-05-04:添加了markdown环境下,超链接的引用功能。
- 2024-04-07:由于https://gitee.com/MichiyamaKaren用户的贡献,插件支持最新的
Better BibTex for Zotero插件。
- 2024-04-22: 由于https://gitee.com/fkguo用户的贡献,插件的
citekey支持"-"和":"等特殊符号。
- 2024-04-22: 由于https://gitee.com/awwaawwa用户的贡献,插件的支持多个分组。
- 2024-06-13: 由于https://gitee.com/cesaryuan用户贡献,在使用
exportBibLatex的时候,插件支持\citet和\citep命令。
- 2024-07-09: 由于https://gitee.com/aasll用户的贡献,插件支持自定义ref文件的位置,并支持使用自定义通配符。
- 2026-02-02: 由于https://gitee.com/aasll用户的贡献,在md和tex文件右上角添加了小按钮来插入引用。
- 2026-02-04: 由于https://gitee.com/aasll用户贡献,修复了添加引用无法检测已经添加进来的重复条目的问题,修复了'update biblatex entries'功能,并增强了返回结果的体验。
- 2026-04-26:增加了对pandoc-crossref格式的图片,表格之类的引用预览。
2026-04-20:重要更新
- 将js插件转换成ts,模块化,方便准确的代码提示。
- 增加了状态栏的command picker按钮,点击可以显示命令列表。
- 增加md文件中尖角引用和@引用的预览和建议列表功能,并做成可配置项(显示和隐藏)。
- 增加了json-rpc字段的排除配置(有时候一些不需要的字段不想显示在bib文件中)。
教学视频
链接: https://pan.baidu.com/s/10FE43K7ZR4LhHv19_5qrnw?pwd=bjf6 提取码: bjf6 复制这段内容后打开百度网盘手机App,操作更方便哦
--来自百度网盘超级会员v9的分享
| |