twineconvert

free · in-browser · no upload

CSL-JSON to Markdown
Converter

Drop your CSL-JSON file. We'll convert it to Markdown right here in your browser, your file never leaves your device.

or drop your file

Select your file here to get started

or drop your file here.

Accepts .json

nothing uploaded no file size cap no signup

How it works

Three steps. No upload, no signup.

  1. 1

    Drop your file

    Click the dropzone above or drag a CSL-JSON from your desktop. Files of any size, there's no upload, so there's no upload limit.

  2. 2

    Convert in your browser

    The conversion runs entirely in this tab using JavaScript and WebAssembly. Your file never touches our servers, we don't have any.

  3. 3

    Download

    Get your Markdown the moment the conversion finishes. Convert another, or close the tab.

Files stay on your device

Your file is never uploaded. The entire conversion runs in your browser using WebAssembly. We can't see what you convert because we have no server to see it.

No file size limit

Server converters cap free users at 1-2 GB and gate larger files behind a paid plan. Since nothing uploads, our limit is whatever your browser can handle.

Free, no signup, no ads on conversions

No account required. No watermark on the output. No queue. Drop a file, get a converted file.

Why convert CSL-JSON → Markdown

What this conversion is actually for

CSL-JSON is a structured citation format; this turns it into a formatted Markdown reference list you can paste into Obsidian, a README, a GitHub wiki, or any Markdown note. Parses a Zotero or pandoc CSL-JSON file into a shared bibliographic model, then renders each entry. Everything runs in your browser, no upload.

A real example

You have a Zotero or pandoc CSL-JSON file and want to paste the reference list straight into your Obsidian vault or project README. Drop the file here and get the Markdown back in one step.

Troubleshooting

A reference is missing its author or year.

The render only shows fields the source CSL-JSON actually contained. Open the source and confirm the field is populated before converting.

Formats involved

About CSL-JSON and Markdown

CSL-JSON, Citation Style Language JSON

CSL-JSON is the modern interop format for citation metadata. Zotero exports it natively (right-click a collection → Export → CSL JSON). Pandoc consumes it as `--bibliography file.json` for reference rendering. Every major reference manager (Zotero, Mendeley, Citavi, Papers, Bookends) reads or writes it. Defined by the Citation Style Language project; covers ~100 fields across journals, books, chapters, theses, software, datasets, and more. The de-facto replacement for BibTeX in modern academic toolchains.

How to open

Any JSON viewer or text editor. Zotero imports via File → Import → CSL JSON. Pandoc references it as bibliography input. JabRef, Citavi, and Bookends all accept CSL-JSON drop-ins.

Full CSL-JSON format guide →
Markdown, Markdown

Markdown is plain text with simple punctuation conventions for formatting, # for headings, * for lists, ** for bold, links as [text](url). Created by John Gruber in 2004 and now the default for GitHub READMEs, documentation sites, and modern note-taking apps (Obsidian, Notion-export, Bear).

How to open

Any text editor (raw). Rendered: GitHub, GitLab, VS Code preview, Obsidian, Bear, Notion (importable), Typora, MarkText, Markdown Editor.

Full Markdown format guide →

You may also need

More tools people use alongside this one

Related tools

Convert other files to Markdown

Convert your CSL-JSON to other formats

FAQ

Common questions

Is this CSL-JSON → Markdown converter really free?

Yes. No signup, no watermark, no daily file count limit. Every conversion runs in your browser, your file never touches our servers because there are no servers.

Where does my file go when I convert it?

Nowhere. The conversion runs entirely in your browser using JavaScript and WebAssembly. Your file is never uploaded to our servers. We don't have any servers handling files, there's nothing for us to log, store, or accidentally leak.

What's the maximum file size?

Whatever your browser can hold in memory. Practically, this means a few hundred MB on most computers, significantly larger than the 1-2 GB caps that server-upload converters charge for. Very large files (multi-GB) may require closing other browser tabs first.

Why convert CSL-JSON to Markdown?

Cross-tool bibliography exchange between reference managers. Documentation, READMEs, notes, blog posts. The most common reason to convert is compatibility, Markdown works in places where CSL-JSON doesn't, or vice versa.

How do I open a CSL-JSON file in the first place?

Any JSON viewer or text editor. Zotero imports via File → Import → CSL JSON. Pandoc references it as bibliography input. JabRef, Citavi, and Bookends all accept CSL-JSON drop-ins.

Does this work offline?

Once the page is loaded, the conversion itself runs entirely offline. The first time you use a tool, your browser downloads the conversion library (a one-time cache). If you reload while offline, the page won't load, but you can install the site as a Progressive Web App for full offline use.

Can I convert multiple files at once?

Single file at a time for now. Batch conversion is on the roadmap, for now, drop one file, download the result, then convert the next.