Turn JSON into readable Markdown: objects become nested lists and arrays of objects become tables.
How to use the JSON → Markdown
- Paste JSON.
- Copy the Markdown.
Good for
Documenting API responses, config files and data samples in READMEs and docs.
How the conversion works
Each key of an object becomes a bullet with the key in bold, followed by its value. Nested objects and arrays become indented lists under their key, so the structure stays visible. An array where every item is an object becomes a table: the columns are every key that appears in any item, so a key missing from one row leaves that cell empty. Arrays of plain values become simple bullet lists. Values inside table cells that are themselves objects or arrays are written as compact JSON, and pipe characters are escaped so the table doesn't break.
Fixing errors and odd output
If the JSON doesn't parse, you see the parser's message instead of output; the usual causes are a trailing comma, single quotes instead of double quotes, or unquoted keys copied from JavaScript. Comments aren't allowed in JSON either. Very wide tables happen when items have many keys; trim the sample to the fields that matter before converting. Long arrays make long documents, so for docs a few representative items are usually enough.