Convert JSON to Markdown
Table, free & instant

A Markdown table in four steps

No account. No upload. No nonsense.

Related JSON tools

Common questions answered

Converting JSON to Markdown tables

Markdown tables display structured data beautifully in README files, GitHub issues, documentation sites, and any Markdown viewer. Converting JSON to Markdown is useful for creating documentation from API responses, presenting configuration options, and sharing data in pull request descriptions.

This tool converts JSON arrays of objects into Markdown table syntax. Each key becomes a column header, each object a row, and values are formatted as cells. The converter handles alignment, escapes pipe characters, and truncates long strings. For nested objects, values display as inline JSON.

[
  {"name":"Alice","role":"admin","active":true},
  {"name":"Bob","role":"user","active":false},
  {"name":"Charlie","role":"editor","active":true}
]

| name    | role   | active |
|---------|--------|--------|
| Alice   | admin  | true   |
| Bob     | user   | false  |
| Charlie | editor | true   |

Get the most out of this tool

• Markdown tables work best with flat objects — flatten nested structures first for the most readable output.
• Use Markdown tables in GitHub PR descriptions to present before/after comparisons of config changes.
• Pipe characters (|) in values are automatically escaped to prevent breaking the table structure.

JSON to Markdown table conversion

Markdown tables are the standard way to present tabular data in documentation, README files, GitHub issues, and technical writing. The pipe-delimited format (| column1 | column2 |) is rendered as a proper HTML table by GitHub, GitLab, Confluence, Notion, and most Markdown processors. Converting a JSON array of objects to a Markdown table instantly produces documentation-ready tabular data from API responses or dataset samples.

The conversion algorithm maps each JSON object's keys to table column headers and each object's values to table rows. The headers row is followed by a separator row of dashes (| --- | --- |) that defines column alignment. Left-alignment is the default; you can specify centered (:---:) or right-aligned (---:) columns by modifying the separator. Values are inserted as their string representations, with pipe characters in values escaped as \| to avoid breaking the table structure.

Column width and alignment in Markdown tables are visual hints for the source editor — rendered Markdown ignores the actual width of the dashes and pipes. The table renders correctly whether you write | --- | or | :---------- |. For source readability in editors like VS Code, auto-formatted Markdown tables pad columns to equal widths. This tool generates compact (minimum-width) tables — pipe-aligned formatting is optionally available for source readability.

JSON arrays with nested objects require a decision about how to handle nesting. The converter flattens nested objects using dot-notation keys (address.city) for the column header and includes the nested value as a string in the cell. Deeply nested objects can produce long column names, but the resulting table is still valid Markdown. For very complex nested structures, flatten the JSON first before converting to Markdown for cleaner column headers.

GitHub Flavored Markdown (GFM) extends standard Markdown tables with column alignment syntax that GitHub renders. Documentation in GitHub README files, CHANGELOG.md, and GitHub wiki pages all support GFM table syntax. Converting API response samples to Markdown tables for inclusion in API documentation or README files is a common documentation workflow — this tool handles that conversion in seconds.

Markdown tables are also useful in Confluence and Jira documentation. While Confluence has its own table format, many teams write documentation in Markdown and import it into Confluence via its Markdown import feature or the Markdown Confluence Sync plugin. The converted Markdown table from this tool can be pasted directly into these documentation systems after minor adjustments for each platform's Markdown variant.

When developers use this tool

Additional frequently asked questions