NewAPIVerve Academy: free courses and certifications anyone can verify.Explore the Academy →

Markdown Table Generator API

POST

Build clean GitHub-flavored markdown tables from raw data.

Markdown Table Generator converts structured data into properly formatted markdown tables with customizable column alignment.

Try it — live request, no key required

Request
POSTapi.apiverve.com/v1/markdowntable
Body
Verification
Format

No key required to try it. Get a key to use it in your app.

Example
{
  "status": "ok",
  "error": null,
  "data": {
    "markdown": "| Name | Age | City |\n| --- | --- | --- |\n| John Doe | 30 | New York |\n| Jane Smith | 25 | Los Angeles |\n| Bob Johnson | 35 | Chicago |",
    "columnCount": 3,
    "rowCount": 3,
    "cellCount": 12,
    "headers": [
      "Name",
      "Age",
      "City"
    ],
    "alignments": [
      "left",
      "left",
      "left"
    ]
  }
}

About the Markdown Table Generator API

Send column headers and rows as JSON and get a markdown table back, which makes it a quick JSON to markdown table step in a docs or report pipeline. Outputs GitHub-flavored markdown tables ready for documentation, README files, and any markdown-compatible platform. Pipes and line breaks inside cells are escaped for you, so data with odd characters does not break the layout.

Common uses are release notes generated from a database, benchmark results written into a README by a CI job, status tables posted to a chat channel, and changelogs built from an issue tracker. You can set one alignment for every column or pass a list to align each column left, center or right.

On the Free plan you get the markdown string, the headers and the column count. Paid plans also return the row count, the total cell count and the alignment that was applied to each column, which helps when you need to validate or log what the generator produced.

How it works

The table is built from headers and rows. The header row is written as | a | b | c |, followed by a separator row whose cells depend on alignment: --- for left, :---: for center and ---: for right. Each entry in rows is an array of cell values in header order.

Rows are normalised to the header length. A short row is padded with empty cells and a long row is cut to the number of headers, so extra values are dropped silently. Each cell is converted to a string, | is escaped as \|, and line breaks are replaced with a space so a cell never spills onto a new line. null and undefined become empty cells. Cells are not padded to equal widths, which keeps the output compact; markdown renderers align columns themselves.

alignment takes either a single value applied to every column or an array with one entry per column. A shorter array is filled out with left. Any value other than center or right renders as a plain --- separator. columnCount is the number of headers, rowCount the number of data rows, and cellCount counts the header row as well, so 3 columns and 3 rows give 12. alignments echoes the values applied per column. On the Free plan rowCount, cellCount and alignments are null, though the markdown itself still honours your alignment.

What people use it for

Documentation Generation
Create formatted tables for README files and technical documentation
Data Presentation
Convert API responses or datasets into readable markdown tables
Report Building
Generate tabular reports in markdown format for various platforms
Content Management
Create consistent table formatting across documentation systems

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents

Other ways to use Markdown Table Generator

Same data, same APIVerve account, same credit balance — one key works on all of them.

Questions.

Common questions about the Markdown Table Generator API.

Read the docs →
Does the generated output render directly in GitHub README files?
Yes. The output formats tables according to GitHub-flavored markdown specifications, including standard pipe separators and hyphens for header dividing lines. It renders cleanly in GitHub READMEs, pull requests, wikis, and documentation sites.
Can I set different alignments for different columns?
Yes. You can pass a single alignment value such as left, center, or right to format every column uniformly, or provide an array of alignments to format each column independently.
How far does the Starter plan go for generating tables?
The Starter plan covers up to 200,000 table generations per month at 1 credit per call. That works out to about $0.15 per 1,000 tables. If you are testing or running occasional jobs, the Free plan provides 200 calls each month at no charge.
Are row count, cell count, and column alignments included on the Free plan?
No. The total row count, overall cell count, and column alignment array are premium fields reserved for paid subscriptions. Free plan responses still return the complete markdown table, the headers array, and the column count.
Can the table handle mixed numbers and text across rows?
Yes. The rows array accepts standard cell values across your columns, whether your data contains strings, numbers, or empty values. Markdown Table Generator formats each cell neatly into the resulting markdown string.
Can I send an array of JSON objects instead of row arrays?
Yes. Send rows as objects, such as [{"name":"John","age":30}], and the headers come from the keys in the order they first appear, with missing keys left blank. Pass headers as well to choose and order the columns. Nested objects are printed as JSON.

Ready to build with Markdown Table Generator? Start with 200 free credits — one key unlocks all 404+ APIs.

Explore the catalog

404+ APIs on the same key and the same response shape.

Browse all APIs