What is CSL-JSON used for?

CSL-JSON (Citation Style Language JSON) is the native bibliography format for Pandoc, citeproc, and tools like Zotero's better-bibtex. Pandoc reads a .json bibliography with --bibliography to render citations in any CSL style.

How are authors split?

Authors joined by `and` are split into separate CSL name objects. Names in `Last, First` form map to family and given; a single token without a comma is treated as a family name.

How is the year handled?

The BibTeX year becomes a CSL issued date with a date-parts array, for example `[[2021]]`. This is the structure Pandoc and citeproc expect for sorting and rendering dates.

Which entry types are mapped?

Common types map to CSL types: article maps to article-journal, book to book, inproceedings to paper-conference, phdthesis to thesis, and techreport to report. Unknown types fall back to the generic document type.

Is anything uploaded?

No. The BibTeX is parsed and converted entirely in your browser with JavaScript. Your bibliography data never leaves your device.

BibTeX to CSL-JSON Converter

Convert BibTeX to CSL-JSON

CSL-JSON is the bibliography format that Pandoc, citeproc-js, and reference managers like Zotero use internally. If you write in Markdown and render with Pandoc, a .json bibliography is often cleaner to work with than .bib. This tool reads standard BibTeX entries and emits a CSL-JSON array you can drop into your Pandoc workflow.

How it works

The parser scans for @type{key, ...} blocks, tracking brace depth so nested braces inside a field value do not end the entry early. Each field = {value} or field = "value" pair is captured, and surrounding braces and quotes are stripped.

Fields are then mapped onto CSL variables: title→title, journal/booktitle→container-title, volume→volume, number→issue, pages→page (with -- normalised to -), doi→DOI, publisher→publisher. The author and editor fields are split on and into CSL name objects with family/given. The year becomes an issued object whose date-parts is [[year]]. The BibTeX entry type chooses the CSL type (@article→article-journal, @inproceedings→paper-conference, and so on).

Notes

The output id of each CSL item is the BibTeX cite key, so in-text citations like [@Smith2021] keep working after conversion. Page ranges written with a single hyphen, an en-dash, or -- are all normalised to a single hyphen, which is what CSL expects.