How to use the JSON to Markdown Table
Generate Markdown tables in seconds:
1
Paste a JSON array
Paste an array of objects — each object becomes a table row, each key becomes a column header.
2
Choose column alignment
Select left, center, or right alignment — applied to all columns via the GFM separator row.
3
Click Convert
Get a formatted Markdown table. Switch to Preview mode to visually verify the output before copying.
4
Copy into your Markdown file
Paste directly into any .md file, GitHub README, Notion page, or Markdown editor.
When to use this tool
Use this whenever you need a Markdown table from structured JSON data:
- →Generating a data table for a GitHub README or open-source project documentation from a JSON file
- →Creating feature comparison or pricing tables in docs sites from structured JSON data
- →Converting API response samples or endpoint reference data to human-readable tables
- →Building Markdown content from JSON data exports for wikis, Notion, or Confluence pages
- →Formatting config option tables for a library's README from a JSON schema or defaults file
- →Turning a JSON report or data export into a shareable Markdown table for a blog post or changelog
Frequently asked questions
Q:What JSON structure does the tool expect?
An array of objects where each object represents one table row. The union of all keys across all objects is used as column headers — so sparse arrays with inconsistent keys are handled correctly, with missing keys rendering as empty cells.
Q:Does the output work on GitHub and GitLab?
Yes. The tool generates GFM (GitHub Flavored Markdown) pipe table syntax, which is fully supported by GitHub, GitLab, Bitbucket, and most static site generators including Jekyll, Hugo, and Docusaurus.
Q:How is column alignment controlled?
Use the Left / Center / Right toggle in the toolbar. The alignment is reflected in the separator row between the header and data rows — :--- for left, :---: for center, and ---: for right — as per the GFM table spec.
Q:How are nested objects and arrays handled?
Nested objects and arrays are serialised as compact JSON strings inside the cell. For the cleanest tables, flatten your JSON before converting — but the output is always valid Markdown regardless of nesting depth.
Q:What happens if values contain pipe characters?
Pipe characters (|) inside cell values are automatically escaped to \| so they don't break the table column structure. You don't need to pre-process your data.
Q:Can I preview the table before copying?
Yes. After converting, click the Preview tab in the output panel to see a rendered HTML table. This lets you visually check column widths, alignment, and empty cells before pasting into your Markdown file.