DevKits

Markdown Table Generator — Build GFM Tables From CSV or Data Grid

Generate GitHub-flavored Markdown tables from a spreadsheet-style grid or by pasting CSV / TSV data. Column alignment (left / center / right), automatic pipe escaping, and human-readable padding. Import from Excel / Google Sheets. 100% local.

Last updated:

Build a Markdown table two ways: (1) fill in a spreadsheet-style grid — headers, rows, alignment per column — or (2) paste CSV / TSV and let the tool auto-import. Output is GFM-compliant with automatic pipe escaping and human-readable column padding.

What is Markdown Table?

Hand-writing Markdown tables is tedious and error-prone: you have to count characters to keep columns aligned, remember to escape pipes inside cells, and get the divider row right (--- vs :---: vs ---:). This tool does all three automatically. Fill in a grid of headers and rows (or paste CSV / TSV from Excel / Google Sheets — Ctrl-A, Ctrl-C, Ctrl-V straight in), pick column alignments with one click, and get a beautifully padded GFM table ready to paste into any README, GitHub issue, or docs site. Column padding is optional — turn it off for smaller output when byte count matters (email templates, minified sources).

How to build a Markdown table online

  1. 1Choose 'grid' mode to fill cells directly, or 'import' to paste CSV / TSV.
  2. 2Type headers in the top row, data in subsequent rows. Add / remove rows and columns with the +/- buttons.
  3. 3Set alignment per column: left, center, right, or none.
  4. 4Copy the generated Markdown from the output pane.

Use Cases

Convert Excel / Sheets data to Markdown

Copy a range from Excel or Google Sheets, paste into the Import tab — the tool auto-detects tabs and produces the Markdown table.

Comparison tables in README files

Compare libraries, plans, features side by side. Better readability than raw Markdown syntax by hand.

GitHub issue templates and PR descriptions

GitHub renders Markdown tables everywhere — issue templates, PR descriptions, wiki pages. Build once, paste anywhere.

Docs / blog posts

Any static site generator that supports GFM (MkDocs, Hugo, Astro, Docusaurus, Next.js MDX) renders these tables.

Key Concepts

GFM (GitHub Flavored Markdown)
The Markdown extension GitHub uses (and specced in 2017 as a strict superset of CommonMark). Tables, task lists, strikethrough, and autolinks are all GFM additions.
Divider row syntax
The second row of a Markdown table uses --- to declare a column. Prefix with : for alignment: :--- left, :---: center, ---: right. No colons = renderer default (usually left).

Tips & Best Practices

  • GFM tables can't span multiple lines per cell — the tool folds line breaks to spaces automatically. If you need multi-line cells, use raw HTML <table>.
  • Column padding makes the source easier to read and diff, but adds bytes. For minified output, turn it off.
  • Alignment (:---: etc.) is stored per-column and affects rendering — center-aligned numbers vs left-aligned text is a subtle but useful signal.
  • Not every Markdown renderer supports tables (blogging platforms like Ghost historically didn't). Test in your target renderer before shipping.

Frequently Asked Questions

How do I import a table from Excel or Google Sheets?

Copy the cells from your spreadsheet and paste into the Import panel — the tool auto-detects tab-separated data. Or paste CSV directly.

How do I set column alignment?

Click the alignment button above each column: left ← , center ↔, right → . GFM tables encode this with :--- (left), :---: (center), and ---: (right) in the divider row.

What if my cells contain the pipe character?

The tool automatically escapes each | as \| — GFM's required syntax. Newlines inside cells are also collapsed to spaces because Markdown tables can't span multiple lines.

Which Markdown flavors support tables?

Tables are a GitHub Flavored Markdown (GFM) extension, but they're supported by virtually every modern renderer: GitHub, GitLab, Bitbucket, Discord, Slack (limited), most static site generators, Jupyter notebooks, and most Markdown editors.

Is my data uploaded anywhere?

No. Everything runs locally in your browser.

Related Tools