Markdown Table Generator

Generate formatted Markdown tables from CSV, JSON, or array data with alignment, header styles, width control, and merge hints

Example Results

2 examples

Convert CSV into a padded Markdown table

Turn CSV rows into a readable Markdown table with bold headers, auto alignment, and fixed-width padding

| **Name**     | **Role**     | **Score** |
| ------------ | ------------ | --------: |
| Alice        | Engineer     |       98 |
| Bob          | Analyst      |       87 |
View input parameters
{ "dataInput": "Name,Role,Score\nAlice,Engineer,98\nBob,Analyst,87", "inputFormat": "csv", "delimiter": ",", "hasHeader": true, "alignmentMode": "auto", "headerStyle": "bold", "columnWidths": "12, 12, 8", "mergeRanges": "", "includeMergeHints": true, "padColumns": true }

Generate a Markdown table from JSON objects

Use an array of objects as input and append merge-cell notes for manual Markdown editing

| `quarter` | `sales` | `region` |
| --------- | -------: | -------- |
| Q1        |      120 | APAC     |
| Q2        |      135 | EMEA     |

> Merge cell hints:
> - A2:A3 merged as Half 1
View input parameters
{ "dataInput": "[{\"quarter\":\"Q1\",\"sales\":120,\"region\":\"APAC\"},{\"quarter\":\"Q2\",\"sales\":135,\"region\":\"EMEA\"}]", "inputFormat": "json", "delimiter": "auto", "hasHeader": true, "alignmentMode": "auto", "headerStyle": "code", "columnWidths": "", "mergeRanges": "A2:A3 merged as Half 1", "includeMergeHints": true, "padColumns": true }

Key Facts

Category
Text & Writing
Input Types
textarea, select, checkbox, text
Output Type
text
Sample Coverage
4
API Ready
Yes

Overview

The Markdown Table Generator allows you to instantly convert raw CSV, JSON, or array data into clean, formatted Markdown tables with customizable alignment, header styles, and column widths.

When to Use

  • Converting structured data from spreadsheets or APIs into documentation-ready Markdown.
  • Standardizing table formatting across technical README files or project wikis.
  • Adding complex table layouts with specific alignment and merge hints to your Markdown content.

How It Works

  • Paste your raw data into the input field and select the format (CSV, JSON, or Auto-detect).
  • Customize your output by selecting header styles, column alignment, and enabling padding.
  • Optionally define specific column widths or merge ranges to refine the table structure.
  • Copy the generated Markdown code directly for use in your documentation or web projects.

Use Cases

Creating technical documentation tables from database query results.
Formatting project status reports or task lists for GitHub or GitLab repositories.
Transforming JSON API responses into readable tables for internal team wikis.

Examples

1. Convert CSV to Markdown Table

Technical Writer
Background
A writer needs to include a list of project contributors in a README file based on a CSV export.
Problem
Manually typing out Markdown syntax for a large dataset is error-prone and slow.
How to Use
Paste the CSV data, set the header style to 'Bold', and enable 'Pad Columns' for readability.
Example Config
inputFormat: csv, hasHeader: true, headerStyle: bold, padColumns: true
Outcome
A perfectly aligned, readable Markdown table ready to be pasted into the project documentation.

2. JSON to Markdown with Merge Hints

Developer
Background
A developer is documenting API endpoints and needs to group related parameters.
Problem
Standard tables don't support merging, making it hard to represent grouped data clearly.
How to Use
Input the JSON data, define the merge ranges in the configuration, and enable 'Include Merge Hints'.
Example Config
inputFormat: json, headerStyle: code, mergeRanges: A2:A3 merged as Group 1
Outcome
A clean Markdown table with a footer note explaining how the cells should be logically grouped.

Try with Samples

json, csv, markdown

Related Hubs

FAQ

What input formats are supported?

The tool supports CSV, JSON arrays, and JSON objects.

Can I control the alignment of columns?

Yes, you can set alignment to left, center, or right, or choose auto-detect.

How do I handle merged cells in Markdown?

While standard Markdown does not support native cell merging, this tool provides 'Merge Hints' that you can include as notes below your table.

Can I change the appearance of the header row?

Yes, you can choose between plain, bold, code, or uppercase styles for your headers.

Is it possible to set specific column widths?

Yes, you can specify column widths in the optional configuration field to ensure consistent spacing.

API Documentation

Request Endpoint

POST /en/api/tools/markdown-table-generator

Request Parameters

Parameter Name Type Required Description
dataInput textarea Yes -
inputFormat select No -
delimiter select No -
hasHeader checkbox No -
alignmentMode select No -
headerStyle select No -
columnWidths text No -
mergeRanges textarea No -
includeMergeHints checkbox No -
padColumns checkbox No -

Response Format

{
  "result": "Processed text content",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}
Text: Text

AI MCP Documentation

Add this tool to your MCP server configuration:

{
  "mcpServers": {
    "elysiatools-markdown-table-generator": {
      "name": "markdown-table-generator",
      "description": "Generate formatted Markdown tables from CSV, JSON, or array data with alignment, header styles, width control, and merge hints",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=markdown-table-generator",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

If you encounter any issues, please contact us at [email protected]