JSON to Markdown Table

Convert JSON arrays to Markdown tables for documentation and README files:

About Markdown Tables

Markdown tables are a simple way to display tabular data in documentation, README files, GitHub issues, and other Markdown-compatible platforms.

Example Output

Given this JSON:

[
  {"name": "Alice", "role": "Admin", "active": true},
  {"name": "Bob", "role": "User", "active": false}
]

You get this Markdown:

| name | role | active |
|------|------|--------|
| Alice | Admin | true |
| Bob | User | false |

Which renders as:

nameroleactive
AliceAdmintrue
BobUserfalse

Supported JSON Structures

  • Array of objects — Most common, each object becomes a row
  • Nested values — Automatically stringified
  • Mixed types — Strings, numbers, booleans all supported

Column Alignment

Markdown supports column alignment using colons in the separator row:

| Left | Center | Right |
|:-----|:------:|------:|
| a    | b      | c     |

Use Cases

  • API Documentation — Document request/response formats
  • README files — Display configuration options
  • GitHub Issues — Present data clearly in tickets
  • Technical specs — List features or requirements
  • Database schemas — Document table structures

Limitations

  • Markdown tables don't support cell merging
  • No built-in sorting or filtering
  • Complex nested objects shown as JSON strings
  • Very wide tables may not render well

Related Tools