JSON to Markdown Table
Convert JSON arrays to GitHub-flavored Markdown tables. Handles mixed keys and escapes pipe characters.
What is a Markdown Table?
Markdown is a lightweight markup language that uses plain text syntax to produce formatted documents. A Markdown table uses pipe | characters to separate columns and dashes to create the header separator row. It is supported natively by GitHub, GitLab, Notion, Obsidian, and most documentation platforms.
Converting JSON to a Markdown table is useful for including API response data in README files, creating comparison tables in pull request descriptions, documenting configuration options in wikis, and sharing structured data in documentation that is version-controlled with your code.
JSON to Markdown Table Example
json
[
{ "name": "Alice", "role": "Engineer", "age": 30 },
{ "name": "Bob", "role": "Designer", "age": 27 }
]Generates:
markdown
| name | role | age |
| --- | --- | --- |
| Alice | Engineer | 30 |
| Bob | Designer | 27 |Where to Use Markdown Tables
| Platform | Supported | Notes |
|---|---|---|
| GitHub README / PR | Yes | GitHub-Flavored Markdown |
| GitLab Wiki | Yes | Identical syntax |
| Notion | Yes | Paste as Markdown block |
| Obsidian | Yes | Native table rendering |
| Confluence | Partial | Use Markdown macro |
| Slack | No | Plain text only |