What JSON structures work best for tables?

Arrays of flat objects work best for tables. Each object becomes a row, and each key becomes a column header. For example: [{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}]

How are nested objects handled?

Nested objects and arrays are converted to hierarchical markdown lists with indentation. Each level of nesting adds indentation to show the structure clearly.

What does auto-detect do?

Auto-detect analyzes your JSON structure and chooses the best format: tables for arrays of flat objects, nested lists for complex structures, or code blocks for primitive values.

Can I convert minified JSON?

Yes! Use the "Format JSON" button to prettify minified JSON before conversion. This makes it easier to review and also improves code block output.

How are special values displayed?

Null values appear as italicized "_null_", booleans as inline code (`true`/`false`), numbers as inline code, and empty strings as "_(empty string)_".

What if my array has objects with different keys?

The table will include all unique keys across all objects as columns. Objects missing certain keys will show empty cells for those columns.

JSON to Markdown Converter

Convert JSON data to formatted Markdown. Auto-detects structure to create tables for arrays, nested lists for objects, or code blocks.

JSON Input

Options

Output Format

List Indent Size

Markdown Output

Paste JSON to see the markdown output

Arrays of objects convert to tables; nested structures convert to lists

Conversion Examples

Array of Objects → Table

[
  {"name": "Alice", "role": "Dev"},
  {"name": "Bob", "role": "Designer"}
]

Converts to:

| name | role |
| --- | --- |
| Alice | Dev |
| Bob | Designer |

Nested Object → List

{
  "project": "App",
  "deps": {"react": "18"}
}

Converts to:

- **project:** App
- **deps:**
  - **react:** `18`

Features

Smart Format Detection

Array to Table

Nested List Output

Code Block Mode

JSON Formatting

Customizable Output

Common Use Cases

API Documentation

Convert API response examples to readable markdown tables for documentation.

README Files

Transform package.json or config files into formatted markdown for project READMEs.

Data Presentation

Convert JSON datasets to markdown tables for reports, wikis, or presentations.

Configuration Docs

Document complex configuration objects as nested markdown lists.

Frequently Asked Questions

JSON to Markdown Converter

Convert JSON data to formatted Markdown. Auto-detects structure to create tables for arrays, nested lists for objects, or code blocks.

JSON Input

Options

Output Format

List Indent Size

Markdown Output

Paste JSON to see the markdown output

Arrays of objects convert to tables; nested structures convert to lists

Conversion Examples

Array of Objects → Table

[
  {"name": "Alice", "role": "Dev"},
  {"name": "Bob", "role": "Designer"}
]

Converts to:

| name | role |
| --- | --- |
| Alice | Dev |
| Bob | Designer |

Nested Object → List

{
  "project": "App",
  "deps": {"react": "18"}
}

Converts to:

- **project:** App
- **deps:**
  - **react:** `18`

Features

Smart Format Detection

Array to Table

Nested List Output

Code Block Mode

JSON Formatting

Customizable Output

Common Use Cases

API Documentation

Convert API response examples to readable markdown tables for documentation.

README Files

Transform package.json or config files into formatted markdown for project READMEs.