TableForge

Markdown table generator

Type in the grid or paste a block of cells from Excel, set the alignment per column and copy a tidy GitHub-flavored Markdown table.

Markdown table syntax in one minute

| Left   | Center | Right |
|:-------|:------:|------:|
| a      |   b    |     c |
  • The separator row (dashes) is required, and it is what turns lines of pipes into a table.
  • Colons set alignment: left :---, center :---:, right ---:.
  • Leading and trailing pipes are optional but recommended.
  • Inline formatting works inside cells: **bold**, `code`, links.

Already have the data?

Convert straight from a file: CSV to Markdown, Excel to Markdown or JSON to Markdown table. To go the other way, use Markdown to CSV.

Where GFM tables render

GitHub and GitLab READMEs, issues and wikis, Bitbucket, Obsidian, Typora, Docusaurus, MkDocs, Hugo and Jekyll (kramdown). Plain CommonMark does not include tables; they are a GFM extension.

Questions people ask

How do I make a table in Markdown?

Write the header cells between pipes, add a separator row of dashes under it, then one line per row: | Name | Score | then | --- | --- | then | Ada | 98 |. This is the GitHub Flavored Markdown (GFM) table syntax, which GitHub, GitLab, Obsidian, Notion import, Reddit and most static-site generators understand.

How do I align columns in a Markdown table?

Put colons in the separator row: :--- aligns left, :---: centers and ---: aligns right. In the generator, click the arrow button above a column to cycle through the alignments.

Can I put a pipe character or a line break inside a cell?

Escape a pipe as \| so it is not read as a column boundary; the generator does this for you. GFM has no multi-line cells, but <br> works on GitHub and most renderers, so line breaks are written as <br>.

Can Markdown tables merge cells?

No. GFM tables have no colspan or rowspan. If you need merged cells, use an HTML table (our HTML table generator), which most Markdown renderers accept inline.

Do the columns need to line up in the source?

No. Renderers ignore the extra spaces. Padding just makes the raw file easier to read and diff. Turn off “Pad columns” for the most compact output.