How do I turn a JSON array into a Markdown table?

Paste an array of objects like [{"name":"Ada","role":"eng"},{"name":"Linus","role":"maint"}] into the input box. The tool reads every object, builds the column headers from the union of all keys, and writes one table row per object. You get a finished pipe table such as | name | role | with a separator line under it, ready to copy straight into a GitHub README or pull request.

What happens when objects have different fields?

The columns are the union of all keys across every object, kept in the order each key first appears. If one object has a team field that another lacks, team still becomes a column and the object without it gets a blank cell in that position. So mixed-shape data like [{"a":1,"b":2},{"a":3}] still lines up correctly, with the second row showing an empty cell under b instead of dropping the column.

My cell value contains a pipe character, will it break the table?

No. A literal pipe inside a value would normally end the Markdown cell early and shift every later column, so the tool escapes it to a backslash pipe before writing the row. A value like cat file | grep error comes out as cat file \| grep error and renders as one cell. Backslashes themselves are escaped too, so a Windows path stays readable.

How are nested objects and arrays handled?

A nested object or array is converted back to compact JSON and placed in a single cell, so a field like {"k":"v"} shows up as {"k":"v"} and a list shows up as ["x","y"]. This keeps the structure visible and copy-paste accurate instead of printing object Object. If you need each nested key as its own column, flatten the JSON first with a JSON flatten tool, then convert.

Can I set column alignment?

Yes. Pick left, center or right and the separator row under the header changes to match: :--- for left, :---: for center and ---: for right. GitHub and most Markdown renderers read that separator to align the whole column. Alignment is one setting for all columns here, which covers the common case of a uniformly aligned table; per-column alignment is rarely needed for generated tables.

Is my data uploaded anywhere?

No. Parsing, the key union, escaping and table building are plain JavaScript that runs inside your browser tab, so the JSON never leaves the page. The one caveat is the share link: it encodes your input in the URL, so a shared link pasted into chat records the data in the recipient server access log. For private payloads use the copy button and paste the text rather than sharing the URL.

Drop an API response into a pull request

You hit an endpoint and get back an array of user or product objects, and you want reviewers to read it without scrolling through raw JSON. Paste the array, get a Markdown table with one row per object, and the columns auto-built from the keys. Copy it into the PR description and the reviewer sees a clean grid instead of a code block they have to mentally parse.

Document a config or schema as a table

A list of settings or fields lives as JSON in your repo. Convert it to a Markdown table so the README shows name, type, default and description as proper columns. When a field is missing one of those keys, it just gets a blank cell, so a half-documented schema still renders cleanly while you fill in the gaps.

Summarize query results in a changelog

You exported a small result set as a JSON array and want it in the release notes. Paste it, pick center alignment for the numeric columns, and copy the table straight into the changelog. No spreadsheet round trip, and the pipe-heavy command strings in your data stay intact because every cell is escaped.

Turn a Notion or Airtable export into Markdown

Tools that export rows as JSON arrays give you data that is awkward to read inline. Run it through here to get a Markdown table you can paste into a doc, a wiki page or a Slack message that supports Markdown. The key union means even rows with extra fields keep every column.

JSON to Markdown Table converter

Paste a JSON array of objects, get a clean GitHub-flavored Markdown table. Key union, pipe escaping, alignment, all in your browser.

Runs locally
Category Format Converter
Best for Turning pasted content or local files into a handoff-friendly format.

Column alignmentLine breaks in a cell

JSON input

Markdown output

What this tool does

JSON to Markdown Table turns an array of JSON objects into a ready-to-paste Markdown pipe table for GitHub READMEs, pull requests, issues, Notion, changelogs and technical docs. It reads every object in the array, takes the union of all keys as the column header in first-seen order, and fills a missing field with a blank cell so rows with different shapes still line up. Cells are made table-safe automatically: a literal pipe becomes an escaped pipe so it cannot break the row, and a line break inside a value is either flattened to a space or kept as a br tag, your choice. Nested objects and arrays are stringified back to compact JSON so the structure survives in a single cell instead of printing as object Object. Pick left, center or right alignment and the separator row updates to match. Everything runs as plain client-side JavaScript with one-click copy and a shareable URL, and nothing is ever uploaded.

Tool details

Input: Files + Text + Structured content; The page exposes text boxes, numeric controls, file pickers, or structured inputs depending on the tool.
Output: Live result + Copy; The result area focuses on usable output, with copy, download, or preview actions when supported.
Privacy: Browser-side processing; The main tool logic does not call an external API, so inputs normally stay in the current tab.
Save / share: Shareable URL state; Key settings are encoded in the URL so another person can reopen the same setup.
Performance budget: Initial JS <= 9 KB; No WASM budget is declared, keeping the tool quick to open on mobile.
Best fit: Format Converter · Developer; Category and role tags drive related tools, internal links, and quick fit checks.

How to use

1. Input

Paste or drop your content into the tool panel.
2. Process

Click the button. All processing is local in your browser.
3. Copy / Download

Copy the result or download to disk in one click.

How JSON to Markdown Table fits into your work

Use it when the main problem is getting content from one practical format into another.

Conversion jobs

Turning pasted content or local files into a handoff-friendly format.
Previewing a conversion before you use it in a larger workflow.
Cleaning small format mismatches without opening a full editor.

Conversion checks

Try a small sample first when the source format is messy.
Check character encoding, separators, and line endings after conversion.
Keep the source until the converted output has been reviewed.

Good next steps

These links move the current task into a more complete workflow.

Real-world use cases

Drop an API response into a pull request
You hit an endpoint and get back an array of user or product objects, and you want reviewers to read it without scrolling through raw JSON. Paste the array, get a Markdown table with one row per object, and the columns auto-built from the keys. Copy it into the PR description and the reviewer sees a clean grid instead of a code block they have to mentally parse.
Document a config or schema as a table
A list of settings or fields lives as JSON in your repo. Convert it to a Markdown table so the README shows name, type, default and description as proper columns. When a field is missing one of those keys, it just gets a blank cell, so a half-documented schema still renders cleanly while you fill in the gaps.
Summarize query results in a changelog
You exported a small result set as a JSON array and want it in the release notes. Paste it, pick center alignment for the numeric columns, and copy the table straight into the changelog. No spreadsheet round trip, and the pipe-heavy command strings in your data stay intact because every cell is escaped.
Turn a Notion or Airtable export into Markdown
Tools that export rows as JSON arrays give you data that is awkward to read inline. Run it through here to get a Markdown table you can paste into a doc, a wiki page or a Slack message that supports Markdown. The key union means even rows with extra fields keep every column.

Common pitfalls

Pasting a single object without the surrounding brackets when you meant several. A bare object becomes one row, which is fine, but if you intended an array of records, wrap them in [ ] and separate with commas so each object becomes its own row.
Expecting nested objects to fan out into separate columns. A nested object lands in one cell as compact JSON by design. If you want addr.city and addr.zip as their own columns, flatten the JSON first, then convert.
Leaving a trailing comma in the array. JSON does not allow [{...},] with a dangling comma, so the parser reports an error. Remove the last comma and the table builds.

Privacy

Parsing, the key union, cell escaping and table building are plain JavaScript that runs in your browser tab, so your JSON never leaves the page and nothing is logged. The one caveat is the shareable URL: it encodes your input in the query string, so a share link pasted into chat will record that data in the recipient server access log. For a private payload, use the copy button and paste the text rather than sharing the URL.

FAQ

Tool combos

Folks in your role tend to reach for these alongside this tool.

Browse all tools for this role

JSON to Markdown Table converter

What this tool does

Tool details

How to use

1. Input

2. Process

3. Copy / Download

How JSON to Markdown Table fits into your work

Conversion jobs

Conversion checks

Good next steps

Real-world use cases

Drop an API response into a pull request

Document a config or schema as a table

Summarize query results in a changelog

Turn a Notion or Airtable export into Markdown

Common pitfalls

Privacy

FAQ

CSV to Markdown Table

Markdown Table Generator

JSON to CSV Converter

JSON Formatter & Validator

Angle Converter

Base64 Encoder & Decoder

Base64 to File Converter

BBCode to HTML Converter

Chinese Numeric Converter

Chinese Pinyin Converter

Chinese Zodiac Sign Checker (Sheng Xiao)

Cooking Measurement Converter