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:
| name | role | active |
|---|---|---|
| Alice | Admin | true |
| Bob | User | false |
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
- JSON to CSV — Convert to spreadsheet format
- JSON Table Viewer — Interactive HTML table
- JSON Validator — Validate your JSON first