Markdown Table Generator

Two details separate a table that works from one that quietly breaks. First, pipes inside your data must be escaped as backslash-pipe, or the renderer reads them as extra column separators and the row falls apart — that escaping is applied automatically here. Second, the separator row is mandatory: without it, Markdown treats the whole block as ordinary paragraph text. Cell padding is purely cosmetic and affects only how the source reads in an editor, never the rendered output, so leave it on when the Markdown will be maintained by hand and turn it off when you want the most compact source possible.

A Markdown table is a header row, a separator row of dashes that defines alignment, then one line per data row — every cell wrapped in pipe characters. Colons in the separator set alignment: trailing for right, both ends for centre.

Markdown tables are inherently limited: they cannot merge cells, nest tables or span rows, and every table needs a header row — one is generated for you if your data has none. Alignment applies to all columns at once rather than per column. Very wide tables are awkward in Markdown generally, and some renderers differ slightly in how they handle inline formatting inside cells.

Three rows of framework data become a four-line Markdown table whose separator row reads | ---- | ----- | -------- |, rendering as a proper table on GitHub, GitLab and most static-site generators.

1. Paste your rows, one per line.
2. Tick “no header row” if the first line is data rather than column names.
3. Choose an alignment and whether to pad the cells.
4. Copy the Markdown, or download it as a .md file.

• Leaving unescaped pipe characters inside cell text.
• Omitting the separator row, so the table renders as plain text.
• Forgetting a blank line before the table in some renderers.
• Expecting merged or spanning cells, which Markdown cannot express.

The Markdown Table Generator converts delimited data into a correctly formatted Markdown table. It detects whether your data uses commas, semicolons or tabs, honours quoted fields, escapes any pipe characters that would otherwise break the table, and can pad the cells so the raw Markdown lines up neatly in a text editor.

Developers writing README files, documentation authors and anyone posting tables to GitHub or a wiki.

• Paste straight from a spreadsheet — tab delimiters are detected automatically.
• Escapes pipe characters in your data instead of producing a broken table.
• Handles quoted fields containing commas correctly.
• Optional cell padding so the raw source is readable, plus column alignment.

• Adding a comparison table to a README.
• Converting a spreadsheet range for documentation.
• Formatting data for a GitHub issue or pull request.
• Writing tables for a static-site blog post.