SmartQueryTools

Convert JSON to Markdown Table Online

Convert JSON files to a Markdown table directly in your browser. Copy the output and paste it into any Markdown document.

About converting JSON to Markdown

Turning JSON into a Markdown table is a quick way to show API data where people read text: a GitHub issue, a pull request description, a README, an Obsidian note, or a wiki page that accepts Markdown. Instead of pasting a block of braces, you paste a pipe-delimited table that renders as a grid on GitHub, GitLab and most documentation sites.

Markdown tables work best when they are narrow. JSON records from real APIs often carry 30 or more keys, and a table that wide is unreadable once rendered. Keep only the fields you want with Manage Columns before converting, so the table shows id, title and state rather than every URL and timestamp the API returned. The converter includes the first 1,000 records; for anything longer, a linked CSV file serves readers better.

Cell content is escaped so the table stays valid. A pipe character inside a value becomes \|, and line breaks inside a value become <br>, which GitHub renders as a break inside the cell. Null values leave the cell empty. Nested objects and arrays print as compact JSON text, which gets hard to read in a table, so flatten nested JSON before you publish from it.

Worked example

A small sample file, converted with the default settings.

Input (JSON)

[
  {
    "id": 4101,
    "title": "Login fails on Safari 17",
    "state": "open",
    "comments": 3,
    "created": "2026-03-02",
    "assignee": "maria"
  },
  {
    "id": 4102,
    "title": "Export slow, then times out",
    "state": "closed",
    "comments": 8,
    "created": "2026-03-03",
    "assignee": null
  },
  {
    "id": 4103,
    "title": "Add dark mode",
    "state": "open",
    "comments": 12,
    "created": "2026-03-05",
    "assignee": "dev-team"
  },
  {
    "id": 4104,
    "title": "Crash on empty file",
    "state": "closed",
    "comments": 0,
    "created": "2026-03-06",
    "assignee": "li.wei"
  }
]

Output (Markdown)

| id | title | state | comments | created | assignee |
| --- | --- | --- | --- | --- | --- |
| 4101 | Login fails on Safari 17 | open | 3 | 2026-03-02 | maria |
| 4102 | Export slow, then times out | closed | 8 | 2026-03-03 |  |
| 4103 | Add dark mode | open | 12 | 2026-03-05 | dev-team |
| 4104 | Crash on empty file | closed | 0 | 2026-03-06 | li.wei |

What changes when you convert JSON to Markdown

  • The first line lists the keys between pipes, followed by a | --- | separator row.
  • Each JSON record becomes one table row, in the original order.
  • Issue 4102 has a null assignee, so its last cell is empty.
  • No alignment colons are added, so numeric columns such as comments render left-aligned.
  • Pipes inside values are escaped as \| and line breaks become <br>.

Your file is processed locally in your browser and is never uploaded. The free limit is 50 MB per file; larger files work if your device has the memory for them.

Frequently Asked Questions

Will the table render on GitHub?

Yes. The output is GitHub Flavored Markdown table syntax, which also works on GitLab, Bitbucket, Obsidian and MkDocs. Some chat tools and older Markdown renderers do not support tables and will show the raw pipes.

Can I right-align numeric columns?

Edit the separator row after converting. Change --- to ---: under a column to right-align it, or :---: to centre it. The converter leaves alignment to you.

Why is the table cut off at 1,000 rows?

Markdown output is capped at the first 1,000 records to keep the text manageable. Filter or sample the JSON first if you need a specific subset rather than the first thousand.

What is Markdown format?

Markdown is a lightweight plain-text format that renders as formatted content. Markdown tables can be embedded directly in README files, wikis, documentation sites, and any tool that supports CommonMark or GitHub Flavoured Markdown.

Related Tools