Convert JSON to Markdown

Convert JSON to Markdown in your browser: load your JSON, choose Markdown as the target, and download the result. The converter reports exactly what it could not carry across, and nothing is uploaded to a server.

Convert JSON to MarkdownRuns in your browser. Nothing uploaded.

When you need this

Putting data into a README, a pull request description, an issue or a wiki page, where a rendered table is read at a glance and a fenced JSON block is scrolled past. Useful for API examples, comparison tables and anything a reviewer needs to actually look at.

How to convert JSON to Markdown

Load your JSON

Drag the .json file in, paste the text, or open it straight from a URL — an API response usually arrives as a paste. Nothing leaves your browser at this or any later step.

Choose the target format

Press Ctrl+Shift+K (Cmd+Shift+K on a Mac) to open the conversion panel, then pick Markdown as the target. The source and the result sit side by side.

Read the loss report

The panel shows whether the conversion is lossless for your particular data, and lists every value it had to transform. Adjust indentation, key sorting and null handling if you need to.

Take the Markdown

Download the .md file, copy it, or open it as a new tab to keep working on it in the Markdown views.

What survives the conversion

JSON to Markdown cannot be lossless, because the two formats express different things. Produces a table for arrays of objects. Everything else becomes a fenced code block.

• An array of flat objects becomes a table. Anything else becomes a fenced JSON code block — the converter tells you which it did rather than producing a table with one strange column.
• Pipe characters inside a value are escaped, so a cell containing a|b cannot break out of its column and shift every heading after it.
• Column order follows the first record. Keys that appear only in later records are appended, which keeps the common case stable and predictable.

A worked example

A pipe inside a value, escaped so the table survives:

[
  { "cmd": "ls | wc", "note": "count" }
]

| cmd | note |
| --- | --- |
| ls \| wc | count |

Privacy

The conversion runs in your browser — in a Web Worker for anything above a quarter of a megabyte, so the page stays responsive. Your data is not uploaded, not logged and not stored. There is no account, and the whole thing works offline.

Convert JSON to Markdown