vust

Markdown · JSON to MD

Convert JSON to Markdown

Paste JSON — get a Markdown table for arrays of objects, or a structured list for nested objects. Choose your output style.

Free · No signup · Instant

Free, no signup. Up to 1 MB per request.

Try in Telegram
Auto-formatTables for arraysInstant

Answer

How do I convert JSON to Markdown?

Paste JSON into the converter above. An array of flat objects becomes a Markdown table — one column per key, one row per object; a single nested object becomes an indented list instead. Mixed keys across array items merge into one table with empty cells for anything missing, and nesting past four levels falls back to an inline JSON code block so the result stays readable. Pick Auto and the converter chooses table or list for you, or override the format from the dropdown.

The example below is this converter's actual output for that input.

Convert your own JSON — open @vustMarkdownBot in Telegram.

This tool handles

  • Arrays of flat objects → tables
  • Nested objects → indented lists
  • Column union for mixed keys
  • Primitive values preserved as literals

Not in scope

  • Deep nesting beyond 4 levels (inline JSON code block)
  • JSON Schema-specific conventions

Try it live with the widget above — paste and see the output instantly. For the items under “Not in scope,” the migration guide below covers workarounds and when to use a different tool.

Specimens

JSON to Markdown examples

Paste real JSON in the left column, see the Markdown output on the right.

Array of flat objects → table

JSON

[{"name":"Alice","age":30},{"name":"Bob","age":25}]

Markdown

| name | age | | --- | --- | | Alice | 30 | | Bob | 25 |

Column union across objects

JSON

[{"a":1,"b":2},{"a":3,"c":4}]

Markdown

| a | b | c | | --- | --- | --- | | 1 | 2 | | | 3 | | 4 |

Nested object → list

JSON

{ "user": { "name": "Alice", "age": 30 } }

Markdown

- **user** - **name**: Alice - **age**: 30

How JSON-to-Markdown conversion works

01

Paste JSON — Paste JSON into the input field.

02

Pick format — Auto chooses table for arrays of objects and list for nested objects.

03

Copy — Copy the Markdown output.

JSON edge cases we handle

Column union

Arrays with objects having different keys merge into a union — missing fields render as empty cells.

Primitive values

Strings, numbers, booleans, and null are rendered as literals. Complex nested values become inline JSON code.

Deep nesting cap

Beyond the configured max depth (default 4) nested structures fall back to an inline JSON code block to stay readable.

Invalid JSON

Parse errors are returned as inline warnings — the tool never silently discards broken input.

FAQ

Frequently asked questions

How does it handle nested objects?

Nested objects are rendered as indented Markdown lists. You can also fall back to a JSON code block.

Will column order be consistent?

Yes — columns follow the key order of the first object in the array.

What if my array has objects with different keys?

Column union mode includes all unique keys across all objects, with empty cells for missing values.

Can I get JSON code blocks for nested values?

Yes — deeply nested values are rendered as inline JSON code blocks to preserve readability.

Where next

Related Tools

Convert CSV to Markdown TablePaste CSV data — get a perfectly formatted Markdown table. Auto-detects delimiter, handles quoted cells, multi-line content.Convert Markdown to HTMLRender Markdown into clean semantic HTML — ready for blogs, emails, or static sites. Handles GFM tables, code fences with language hints, and frontmatter strip.Convert Plain Text to MarkdownNormalize plain text into Markdown-ready paragraphs. Numbered and bulleted lists already in Markdown syntax pass through cleanly; auto-detection of headings, URLs, and code blocks ships in a future wave.All tools

Process bigger files in @vustMarkdownBot

500-character free conversions in chat — pay-as-you-go for longer text.

Open Telegram bot