Home › Developer Tools › JSON to Markdown Table
JSON to Markdown Table
Paste a JSON array of objects and get a clean GitHub Flavored Markdown table for READMEs, docs, issues and wikis. Pick and reorder columns, flatten nested objects, set alignment and check the rendered preview.
Last updated:
Columns (untick to hide, arrows to reorder)
Converted locally in your browser; your JSON is never uploaded. Output follows the GitHub Flavored Markdown table syntax.
Advertisement
Advertisement
How to use the JSON to Markdown Table
- Paste your JSON, usually an array of objects such as an API response, or open a .json file. A sample is loaded to start.
- Pick the columns: untick the ones you do not need and use the arrows to change their order.
- Choose how nested data appears: flattened dot columns, compact JSON, or JSON wrapped in code.
- Set alignment and style: column alignment, number alignment, null text, Title Case headers, row numbers and padding.
- Check the Preview tab, then copy the Markdown or download it as a .md file and paste it into your README or issue.
Example: JSON array to Markdown table
[
{"name": "Ada", "role": "Engineer", "salary": 120000, "address": {"city": "London"}},
{"name": "Alan", "role": "Researcher", "salary": 98500.5, "address": {"city": "Manchester"}}
]becomes this table, with the nested address flattened into its own column and the number column right-aligned:
| name | role | salary | address.city |
| ---- | ---------- | ------: | ------------ |
| Ada | Engineer | 120000 | London |
| Alan | Researcher | 98500.5 | Manchester |Markdown table syntax cheat sheet
| Part | Syntax | Notes |
|---|---|---|
| Header row | | Name | Age | | Required. Every table needs exactly one header row. |
| Separator row | | --- | --- | | At least three dashes per column in many renderers; colons set alignment. |
| Left align | :--- | Same as the default on most sites. |
| Center | :---: | Good for short status values such as ✓ or Yes/No. |
| Right align | ---: | Best for numbers, so digits line up. |
| Pipe inside a cell | \| | An unescaped | starts a new cell. |
| Line break in a cell | <br> | Cells cannot span several source lines. |
| Empty cell | | | | Leave the space between pipes empty. |
Tips for readable tables
- Hide what readers do not need. API responses often include IDs, timestamps and URLs; untick those columns to keep the table narrow enough for a README.
- Padding is optional. Renderers ignore the extra spaces, but padded source is much easier to read and review in a pull request diff. Turn padding off for the smallest output.
- Very long values make tables scroll sideways on GitHub. Consider flattening only the fields you need or shortening text before converting.
- Going the other way? For a table that you type by hand, use the Markdown Table Generator; for HTML output, use JSON to HTML Table.
Frequently asked questions
What JSON structures can be converted?
An array of objects works best: each object becomes a row and each key becomes a column. The tool also accepts an object whose values are objects (each becomes a row with a key column), an array of arrays (the first row becomes the header when it contains only strings), an array of plain values (one value column) and a single object (one row).
What happens when objects have different keys?
Columns are the union of all keys in the order they first appear. A row that does not have a key gets an empty cell, or the text you choose for null and missing values, such as null, a dash or N/A.
How are nested objects and arrays shown?
By default nested objects are flattened into dot-notation columns, so address.city becomes its own column, and arrays of plain values are joined with commas. You can instead keep nested values as compact JSON, optionally wrapped in backticks so Markdown shows them as code.
How do I align columns in a Markdown table?
Alignment is set in the separator row under the header: :--- aligns left, :---: centers and ---: aligns right. Plain --- uses the renderer's default, which is left on GitHub. With 'Right-align number columns' on, columns that contain only numbers are right-aligned automatically so digits line up.
What if a value contains a pipe character or a line break?
A raw | would end the cell early, so the tool escapes it as \|. Markdown table cells must stay on one line, so line breaks inside values are replaced with <br>, which GitHub, GitLab and most renderers show as a line break.
Where can I use the generated table?
The output follows the GitHub Flavored Markdown table syntax, supported by GitHub and GitLab READMEs, issues and wikis, Bitbucket, Obsidian, Docusaurus, MkDocs and most static site generators.
Is my JSON uploaded?
No. The conversion runs entirely in JavaScript in this page, so your data never leaves your device.
Are all the tools on FreeToolCabin tested for quality and accuracy?
Yes! Every tool on our site undergoes automated Q/A testing in real browser environments to ensure high precision, correct output, and zero errors. If you happen to spot a bug or have a suggestion, please contact us at [email protected] and our team will review it right away.
Related tools
Markdown Table GeneratorBuild Markdown tables in a grid or paste from Excel/CSV, with alignment and preview.JSON to HTML TableConvert a JSON array of objects into clean HTML table code with CSS styles and a live preview.JSON to CSVConvert JSON data to CSV for spreadsheets.JSON Flatten / UnflattenFlatten nested JSON to dot or bracket path keys, or unflatten flat keys back to nested JSON.JSON to Excel ConverterTurn JSON into a styled .xlsx spreadsheet; nested arrays become their own linked sheets.CSV to JSONConvert CSV data to JSON with live preview.Excel to CSVConvert XLSX spreadsheets to CSV.CSV ViewerOpen a CSV or TSV file as a sortable, filterable table.Excel Viewer (XLSX / XLS)Open XLSX, XLS and ODS spreadsheets in your browser without Excel.Line Ending ConverterConvert text and files between CRLF, LF and CR line endings.Markdown to HTMLConvert Markdown to clean HTML with a live editor.XML to JSONConvert XML to JSON with validation.Text Encoding ConverterDetect and convert text file encodings like UTF-8, UTF-16 and Latin-1.JSON ViewerExplore JSON as a collapsible tree, search keys and values and copy any node's path.TTF to WOFF2 ConverterConvert TTF and OTF fonts to WOFF2 or WOFF and get a ready @font-face CSS snippet.Chmod CalculatorConvert Linux file permissions between checkboxes, octal (755) and symbolic (rwxr-xr-x) notation.JSON to TypeScriptGenerate TypeScript interfaces or types from JSON, with nested types and optional fields.Morse Code TranslatorTranslate text to Morse code and back, then play it as sound or a blinking light, or save a WAV.HTML Table GeneratorBuild HTML tables in an editable grid with styles, header rows, CSV import and live preview.Hex to Text ConverterConvert hex to text and text to hex with UTF-8 support and space, 0x, \x or comma formats.JSON to XML ConverterConvert JSON to well-formed XML with attributes, arrays and pretty print.JSON to YAML ConverterConvert JSON to clean YAML as you type, with indent, quoting and sort options.YAML to JSON ConverterConvert YAML to pretty or minified JSON, with errors pinned to the exact line.HTML to Markdown ConverterTurn HTML or pasted rich text into clean Markdown with tables and live preview.JSON ValidatorCheck JSON with the exact line and column of each error, fix tips and one-click auto-fix.Image to Base64Convert images to Base64 data URIs, CSS backgrounds and HTML img tags in your browser.Base64 to ImagePaste a Base64 string or data URI to preview, identify and download the image.JSON CompareCompare two JSON documents and see every added, removed and changed path.Hex to DecimalConvert hex to decimal instantly with steps and signed mode.Decimal to HexConvert decimal to hex instantly with steps and signed mode.Binary to DecimalConvert binary to decimal instantly with steps and signed mode.Decimal to BinaryConvert decimal to binary instantly with steps and signed mode.Two's Complement CalculatorDecimal to two's complement binary and back for 4-64 bits, with invert-and-add-1 steps.XML to CSV ConverterConvert XML to CSV: detects repeating records, flattens nested data, pick your columns.CSV to XML ConverterConvert CSV to well-formed XML with custom root and row names, escaping and pretty print.TOML to JSON ConverterConvert TOML to JSON and JSON to TOML with a full v1.0 parser and clear error lines.JSON to Go StructTurn JSON into Go structs with inferred types, nested structs and json tags.JSON to Python ClassGenerate Python dataclasses, Pydantic models or TypedDicts with type hints from JSON.KML ViewerOpen KML and KMZ files on an interactive map: placemarks, paths, polygons, folders, export.MySQL to PostgreSQL ConverterConvert MySQL dumps and CREATE TABLE statements to PostgreSQL: types, AUTO_INCREMENT, ENUMs, quotes.Text to CSV ConverterTurn space-aligned, fixed-width, pipe or tab separated text into clean CSV with a live preview.VCF File ViewerOpen vCard .vcf files as contact cards with photos, search and duplicate check, export CSV.XML ViewerBrowse XML as a collapsible tree with search, XPath of any node, attributes and big-file support.JSON to C# ClassConvert JSON to C# classes or records with System.Text.Json or Newtonsoft attributes.JSON SorterSort JSON keys A-Z recursively, sort arrays by value or by a key, then pretty-print or minify.CSV to SQL ConverterConvert CSV to SQL CREATE TABLE and INSERT statements for MySQL, PostgreSQL, SQLite or SQL Server.IPv4 to IPv6 ConverterConvert IPv4 to IPv4-mapped, 6to4 and NAT64 IPv6, extract IPv4 from IPv6, and get int/hex/binary.cURL to Code ConverterConvert curl commands to JavaScript fetch, Axios, Python requests, Node.js, PHP and Go code.Code to ImageTurn code into a beautiful syntax-highlighted PNG with themes, window frame and background.Excel to JSON ConverterConvert Excel sheets (XLSX, XLS, ODS) to JSON with header row, type and shape options.CSV to Excel ConverterConvert CSV files to a real .xlsx workbook with typed numbers and dates, one sheet per file.CSV SplitterSplit a large CSV into smaller files by row count, file count or column value, header kept.CSV MergerCombine many CSV files into one, matching columns by name, with dedupe and a source column.VCF to CSV ConverterConvert vCard (.vcf) contacts to CSV for Google or Outlook, or turn a CSV back into a VCF.Calendar Event (.ics) GeneratorCreate an .ics calendar invite with time zone, reminders and repeats + Google/Outlook links.CSV Column ExtractorPick, reorder and rename CSV columns, filter rows by value, and export a new CSV or JSON.CSV Diff CheckerCompare two CSV files by key column and see added, removed and changed rows cell by cell.CSV Duplicate Row RemoverRemove duplicate rows from a CSV by all or selected columns and download the cleaned file.CSV to HTML TableTurn CSV into clean HTML table code with a live preview, styling options and one-click copy.CSV to Markdown TableConvert CSV to a neatly aligned GitHub Markdown table with column alignment and live preview.CSV TransposeSwap rows and columns of CSV, TSV or pasted spreadsheet data, with delimiter auto-detect.Date Format ConverterConvert any date to ISO 8601, RFC 2822, Unix time and custom strftime, moment or Java patterns.ENV to JSON ConverterConvert .env files to JSON or YAML and JSON back to .env, with quotes and multiline values.File to Base64Convert any file to a Base64 string or data URI with MIME detection, line wrap and download.HTML Table to CSVExtract any table from HTML or page source to CSV, TSV or JSON, with colspan and rowspan handled.IEEE 754 Floating Point ConverterConvert decimals to 32/64-bit IEEE 754 floats: toggle bits, see hex, exact value and rounding error.INI to JSON ConverterConvert INI and CFG files to JSON and JSON back to INI, with sections, arrays and types.IP Address ConverterConvert IPv4 to decimal, hex, binary, octal and back, with class and private/public check.