Cite Extract

Cite Extract is a VS Code extension that extracts the citation keys actually used in your Markdown/Quarto/LaTeX document, then filters your existing bibliography database (CSL-JSON or BibTeX) to export a smaller, cited-only bibliography file. It never modifies your source document or the original bibliography—only writes a new exported file.

Key features:

• Supports Markdown/Quarto (Pandoc) citations like [@key] and inline @key
• Supports common LaTeX commands such as \cite{...} (and \nocite{*} to export all)
• One status-bar button for quick export (default: CSL-JSON, configurable to BibTeX)
• Configurable output directory and filename

Cite Extract

从 md / qmd / tex 文件中提取“文中实际引用到的 citekey”，并从你已有的 BibTeX(.bib) 或 CSL-JSON(.json) 文献库中筛选出对应条目，导出为更小的 .bib/.json。扩展不会修改原始文档或原始文献库，只会生成新的导出文件。

支持的引用格式（常见）

• Markdown / Quarto（Pandoc 风格）：[@key]、[@k1; @k2]、文本中的 @key
• LaTeX：\cite{key}、\citep{key1,key2}、\autocite{...} 等；支持 \nocite{*}（表示导出全部）

使用

打开一个 .md / .qmd / .tex 文件，然后在命令面板运行：

• Cite Extract: Export Cited References as BibTeX
• Cite Extract: Export Cited References as CSL-JSON
• Cite Extract: Export Cited References as BibTeX + CSL-JSON

扩展会尝试从文档的 YAML front matter（bibliography:）或 LaTeX 的 \addbibresource{...} / \bibliography{...} 检测文献库文件路径；如果检测不到，会提示你选择一个 .bib 或 .json 文件。

安全性：扩展不会修改原来的 .md/.qmd/.tex 或原始文献库（.json/.bib），只会输出新的“筛选后的”文件。

配置

• citeExtract.outputBasename: 导出文件名（不含扩展名），默认 references.cited
• citeExtract.outputDirectory: 输出目录（空表示与当前文档同目录；也可填绝对路径或工作区相对路径）
• citeExtract.statusBarFormat: 底部按钮默认导出格式（默认 csl-json，可切换为 bibtex）
• citeExtract.bibConversionFormat: JSON→BibTeX 跨格式转换模式（默认 better-bibtex，丰富字段映射；可切换为 bibtex 最小化转换）
• citeExtract.jsonConversionFormat: BibTeX→JSON 跨格式转换模式（默认 better-csl-json，完整解析 BibTeX 字段；可切换为 csl-json 最小化转换）

注意：同格式导出（bib→bib、json→json）始终保留原始内容不做任何转换。跨格式转换时使用上述设置控制映射质量。