Why Convert JSON to a Markdown Table?
When you query an API and get back a JSON array, the fastest way to document it or share it in a GitHub README is a Markdown table. But formatting it by hand is tedious — especially when the JSON has nested objects or inconsistent keys. This tool flattens, aligns, and formats it in one click.
How Nested JSON Is Handled
Most converters give up on nested objects like {"user": {"name": "Alice", "role": "admin"}}. This tool flattens them to dot-notation column headers: user.name and user.role, so nothing is lost and the table stays readable.
Compatible With
Output is standard GitHub Flavored Markdown (GFM) pipe table syntax. It pastes directly into GitHub README files, Notion, Confluence, Obsidian, HackMD, and any other Markdown editor. No special formatting required.
Frequently Asked Questions
Does it work with API responses?
Yes. If your API returns a JSON array, paste the entire response. The tool finds the array and converts it. If the response has a wrapper like {"data": [...]}, paste just the inner array.
What if my JSON keys are inconsistent across records?
The tool collects all unique keys across every object in the array and creates a column for each. Missing values display as empty cells rather than causing an error.
Is there a size limit?
No server upload, no size limit enforced by us. Processing happens in your browser; very large arrays (>10,000 rows) may take a second on older machines.
Frequently Asked Questions
Can I convert a JSON array to a GitHub README table?
Yes. Paste your JSON array and click Convert. The output is standard GitHub Flavored Markdown pipe-table syntax that you can paste directly into any README.md file.
How does it handle nested JSON objects?
Nested objects are flattened using dot notation. A field like {"user": {"name": "Alice"}} becomes a column header "user.name" in the table.
Does my data get uploaded to a server?
No. All conversion happens entirely in your browser using JavaScript. Your JSON data never leaves your machine.
Can I convert JSON to a Notion table?
Yes. Paste the generated Markdown table directly into Notion. Notion automatically renders pipe-table Markdown as a formatted table.