Convert JSON to Markdown
Table, nested list
or README docs.
Generate GFM-compatible Markdown tables, nested bullet lists and README-style documentation from any JSON. Supports JSON arrays, objects and JSON Schema. Runs entirely in your browser.
Three steps — paste your JSON and get GFM-compatible Markdown.
Paste a JSON array for table or list output. Paste a JSON object or JSON Schema for documentation output. Upload a .json file for larger datasets. The converter accepts any valid JSON structure.
Table produces a GFM pipe table — each array item becomes a row. List produces a nested bullet list — objects and arrays nest recursively. Docs produces README-style sections with a properties table — best for JSON Schema and API documentation.
Copy the Markdown to paste directly into a README, GitHub wiki, Notion page, Confluence doc or any Markdown editor. Download as a .md file to add to your repository.
Each format targets a different JSON structure and documentation need.
| Format | Best JSON input | Use case |
|---|---|---|
| Markdown Table | Array of flat objects | Data tables in README files, GitHub wiki pages, Notion databases, Confluence pages. Each object → one row. Column headers from keys. GFM pipe format. |
| Markdown List | Any JSON — objects, arrays, nested | Hierarchical data display, configuration documentation, API response examples in docs. Nested objects and arrays produce nested bullet lists with recursive indentation. |
| Markdown Docs | JSON Schema or structured config object | README-style API documentation, schema reference pages, configuration guides. Generates a properties table with field name, type, required status and description from each key. |
Common workflows where JSON data needs to become Markdown.
API endpoint lists, configuration parameters, environment variables and dependency tables in README files are much easier to write as JSON and convert to Markdown than to type as pipe tables by hand. Generate the Markdown, paste it into your README, done.
n8n workflows that process JSON data often need to produce Markdown for Slack messages, GitHub issues or Notion pages. Generate the Markdown template from a sample JSON payload here, then adapt it for your n8n Set or Code node.
JSON Schema and OpenAPI schemas describe your API's data structures — but they're unreadable as raw JSON. The Docs output converts a schema to a human-readable properties table with field names, types, required status and descriptions — ready to paste into your API docs.
Notion and Confluence both import Markdown. Paste data-heavy JSON — team rosters, product catalogues, release notes — into the table converter to get a Markdown table you can paste directly into either platform, skipping the manual cell-by-cell entry.
Markdown generated
in your browser. No upload.
The entire Markdown generation runs in JavaScript locally. Your JSON is parsed and traversed entirely in your browser — it is never transmitted to any server. The output is GFM-compatible Markdown that renders correctly in GitHub, GitLab, Notion, Obsidian and any standard Markdown renderer.
The Docs format generates a structured README with a properties table — extracting field names, inferred types, and descriptions from the JSON Schema description field. Start with the JSON Schema Generator to create the schema, then convert it to Markdown documentation here.