How to Convert JSON or CSV to a Markdown Table

Choose the right input for your table

This tool is for turning pasted JSON or CSV text into Markdown table text. It is useful when you have structured data and need a table for documentation, README files, notes, or other Markdown content. Choose JSON when your data is organized as objects or rows; choose CSV when the first line should define the column names. You can also provide your own comma-separated headers and choose left, center, or right alignment.

Convert JSON or CSV to a Markdown table

1. Prepare the data as text. Use valid JSON for JSON input, or place CSV column names on the first line followed by the data rows. Do not submit an empty input.
2. Paste the data into the main input area.
3. Select the matching format: json or csv. Other format values are not supported.
4. If needed, enter custom headers as a comma-separated list. Surrounding spaces are removed from each header, so Name, Email becomes two headers rather than headers with leading spaces.
5. Choose an alignment: left, center, or right. Left alignment is the default.
6. Submit the data and review the generated Markdown table text. If processing fails, check the input format, JSON structure, and whether the data is empty before submitting again.

Read the result and troubleshoot the boundaries

For suitable nonempty JSON row data without custom headers, the keys from the first row provide the table headers. A nonempty JSON object is handled as one table row. For CSV without custom headers, the first line becomes the header row and later lines become data rows.

An empty JSON value is handled as an empty-table result rather than as a populated table. This includes an empty list, empty object, null, false, zero, and an empty string. Malformed JSON produces an unsuccessful result, and valid JSON can also fail when its structure does not provide the expected row shape.

CSV handling is direct: lines and fields are split at newline and comma characters, with surrounding whitespace removed from each field. Fields beyond the available headers are discarded, while missing fields produce blank values. This means quoted commas and other advanced CSV conventions should not be treated as supported. An alignment value outside the supported choices falls back to left-aligned table markers.

Worked example

A documentation writer has a short CSV export with column names on the first line and wants table markup for a README.

Paste the CSV text, select CSV, leave custom headers empty, keep the default left alignment, and submit it for processing.

The result is Markdown table text with a header row based on the CSV header line, a separator row, and subsequent rows for the remaining records.

Limitations

• CSV processing splits directly on commas and newline characters, so quoted delimiters and other advanced CSV conventions are not established. Extra fields can be discarded, and missing fields can become blank values.

Common errors

• Using a format value other than json or csv can make processing fail. Select the format that matches the pasted data, then verify that JSON is well formed and has a suitable row structure.

FAQ

Can I use JSON objects to create a Markdown table?

Yes, when the JSON is nonempty and provides a suitable row-like structure. Without custom headers, the keys from the first row become the table headers; some valid JSON shapes can still fail during processing.

How does the tool choose headers for CSV?

For CSV without custom headers, the first line supplies the headers and later lines supply the rows. The tool splits directly at commas and newline characters, so quoted delimiters and other advanced CSV conventions are not established.

What happens when my JSON input is empty?

An empty JSON value, such as an empty list, empty object, null, false, zero, or an empty string, produces an empty-table result. No submitted data instead causes computation to fail.