JSON to Markdown Table screenshot

JSON to Markdown Table

Convert a JSON array to a readable Markdown table.

Privacy First
0 Runs
Updated 2026-11-07
Runs in your browser
No account needed
Nothing sent to a server
Works offline after load

Convert a JSON array to a readable Markdown table. Paste your content and get an instant result.

Paste a JSON array of objects and this page builds a GitHub-flavoured Markdown table: the union of the objects' keys becomes the header row, and each object becomes a body row.

An array of plain values becomes a single column named value, and a bare object becomes one row whose columns are its keys. Nested values are written as their JSON text rather than flattened into separate columns.

The table is built and escaped in the tab. Nothing is uploaded, and the result can be copied or downloaded as a .md file whose columns line up in a monospaced viewer.

Which shape becomes which table

For an array of objects the header is built in first-seen order across all rows, so a sparse array does not silently drop a column: a missing key becomes an empty cell. Ragged objects therefore keep every column any row mentions.

An array of scalars is a one-column table. A single object is a one-row table. An empty array is refused, because a header with no rows is not a table anyone can use.

  • Array of objects: the union of keys as columns
  • Array of values: one value column
  • Single object: one row from its keys

What the cells contain

Strings are written as text, numbers as their JSON spelling, booleans as true or false, and null as an empty cell. A nested object or array is written as compact JSON, so a reader can see it but the table stays rectangular.

Pipe characters and newlines inside a value are escaped so they cannot break the table's structure. That is the whole of the conversion: no type inference beyond the JSON itself.

How to use the input workspace

Paste the JSON array of objects into the input workspace, or drop a file onto the drop zone, and read the GitHub-flavoured Markdown table in the output panel: the union of the objects' keys in first-seen order becomes the header and each object a body row. An array of plain values becomes one column named value; empty the workspace with Clear or reload an example with Sample.

A missing key becomes an empty cell rather than dropping the column, and an empty array is refused because a header with no rows is not a table. Nested values are written as compact JSON, and pipes and newlines inside a value are escaped so they cannot break the structure.

What to Expect

Best for

  • Turning an API response into a table for a README or a ticket
  • Documenting a list of records without retyping the columns
  • Producing a table that renders in GitHub, GitLab and most Markdown viewers

Not ideal for

  • Deeply nested JSON, which becomes compact JSON text in one cell
  • Very wide records, where the table becomes hard to read
  • CSV output, which has its own converter on this site

What this tool keeps

  • Every key any object mentions, in first-seen order
  • Numbers and booleans as their JSON spellings
  • Pipes and newlines escaped so the grid cannot break

What may need cleanup

  • A nested value that is readable JSON rather than useful columns
  • An empty cell where a key was missing rather than null
  • Column widths, which the download leaves unpadded

Common errors

  • Pasting invalid JSON and reading the parser message as a table error
  • Expecting nested objects to be exploded into columns
  • Pasting an empty array, which is refused by name

Example use cases

  • Documenting a JSON endpoint's response shape
  • Adding a table to a pull request description
  • Turning exported records into a readable summary

Sample input

Paste an array of three objects with the keys region, revenue and growth.

Sample output

A three-column Markdown table with a header row, an alignment row and three body rows in the order the keys first appeared.

Who this is for

  • Developers documenting an API
  • Technical writers turning data into a page
  • Anyone pasting a table into a Markdown file

Frequently asked questions

Which JSON shape becomes a Markdown table?

A JSON array of objects: the union of the objects' keys becomes the header row and each object becomes a body row.

How are nested values shown?

Deeply nested JSON becomes compact JSON text in one cell rather than extra columns.

Are pipes and newlines escaped?

Yes. Pipes and newlines are escaped so the grid cannot break.

Developer program

Build custom tools for your store

Join the SDK program to create useful ecommerce utilities for your store.