Convert JSON to Markdown Table Online
Turn a JSON array into a Markdown table you can drop into documentation. The JSON is parsed in your browser and never uploaded.
Drop a CSV or Excel file here
CSV · XLSX · XLS · XLSM · XLSB
Ready to download as a binary file.
How to convert JSON to a Markdown table
Three steps from endpoints.json to a Markdown table.
1. Paste the JSON
Paste JSON or drop a .json file. Arrays, keyed objects and JSON Lines all work.
2. Check it in the grid
Remove columns that hold long nested JSON: they make the table hard to read. Keep the fields that matter in the doc.
3. Pick a style
Pretty (padded columns) or compact, column alignment, optional bold header, escaping; then copy or download data.md.
Example: JSON in, Markdown out
API endpoints for a README, where only one object has a rate_limit key.
[
{ "method": "GET", "path": "/users/:id", "auth": true },
{ "method": "POST", "path": "/users", "auth": true, "rate_limit": 100 }
]| method | path | auth | rate\_limit |
| :----- | :--------- | :--- | :---------- |
| GET | /users/:id | true | |
| POST | /users | true | 100 |Only the POST endpoint has rate_limit, so the GET row has an empty cell there. The header itself is written as rate\_limit because underscores are escaped.
What changes between JSON and Markdown
Escaping
| is always escaped as \|, and with Escape special chars ticked so are *, _ and `. Here the value rate_limit is written as rate\_limit. It renders as the original text; untick the option if the cells contain Markdown you want rendered.
Line breaks
A line break inside a cell is written as <br>, because a Markdown table row must stay on one line.
Not everything stays typed
true and false become the words true and false, null becomes an empty cell, and that is how they reach the Markdown.
When to convert JSON to Markdown
- Documenting an API response or a list of config options in a README.
- Pasting results from a tool that returns JSON into a GitHub comment.
JSON to Markdown in JavaScript
JSON needs no parser: JSON.parse gives you the data. Then each row is joined with pipes.
import { readFile } from 'node:fs/promises';
const items = JSON.parse(await readFile('endpoints.json', 'utf8'));
const toText = (v) => (v == null ? '' : typeof v === 'object' ? JSON.stringify(v) : String(v));
const header = [...new Set(items.flatMap((o) => Object.keys(o)))];
const rows = items.map((o) => header.map((key) => toText(o[key])));
const cell = (v) => String(v ?? '').replace(/\|/g, '\\|').replace(/\n/g, '<br>');
const line = (cells) => '| ' + cells.map(cell).join(' | ') + ' |';
console.log([line(header), line(header.map(() => '---')),
...rows.map((row) => line(header.map((_, i) => row[i])))].join('\n'));TabularJS reads spreadsheet files, not JSON; JSON.parse is all JSON needs.
Frequently asked questions
How do missing values look in the table?
As empty cells. A key that one object doesn't have, like rate_limit for the GET endpoint, leaves that cell blank between the pipes.
Can booleans be shown as ✓ and ✗?
Not automatically: true and false are written as words. Replace them in the grid before copying, or map them in code.
What happens to nested objects and arrays?
Each one is kept in a single cell as JSON text. To get separate columns (address.city, address.zip), flatten the objects in code first, or split the column in the grid before converting to Markdown.
Can I right-align only the number columns?
The Align option applies to every column. Generate with Left, then change the separator under each number column from :--- to ---: by hand.
Does endpoints.json get uploaded when I convert it to Markdown?
No. The JSON is parsed in your browser and never uploaded.