# Markdown Table Generator

> Paste cells from a spreadsheet or CSV and copy a lined-up GitHub Markdown table, with alignment per column and a live preview.

- Page: https://codethatmoves.com/tools/text/markdown-table-generator/
- Site: Code That Moves
- Category: Text tools
- Free, runs in the browser, nothing is uploaded
- Last checked: 2026-11-14

## What it does

- Reads tab-separated cells copied from Excel, Google Sheets or Numbers
- Reads CSV with comma, semicolon or pipe, including quoted fields
- Paste an existing Markdown table to reformat it; its alignment is kept
- Left, center or right alignment per column
- Pads columns so the table lines up in plain text, counting wide CJK characters and emoji as two columns
- Escapes | in cells and turns line breaks into <br>
- Swap rows and columns, live preview, and the data kept in the page address

## How to use it

1. Select cells in your spreadsheet, copy them and paste them into the box. CSV or an existing Markdown table works too.
2. Set the alignment of each column and choose whether the first row is the header.
3. Copy the Markdown and paste it into GitHub, GitLab, Notion, Obsidian or a README.

## What it checks and why

Markdown tables are not part of the original Markdown; they come from GitHub Flavored Markdown (GFM), which GitHub, GitLab, most static site generators and note apps support. A table is a header row, a delimiter row of dashes, and data rows, with cells split by pipes.

The delimiter row also sets alignment: :--- aligns a column left, :---: centers it and ---: aligns it right. A pipe inside a cell has to be escaped as \|, and a cell cannot hold a real line break, so the tool writes <br> instead, which GitHub renders as a new line.

When you copy cells from a spreadsheet, the clipboard holds them as tab-separated text. The tool reads that directly, so there is no export step: copy, paste, copy the Markdown.

## Specs and sources

- [GitHub Flavored Markdown Spec: Tables (extension)](https://github.github.com/gfm/#tables-extension-)
- [GitHub Docs: Organizing information with tables](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables)
- [RFC 4180: CSV format](https://www.rfc-editor.org/rfc/rfc4180)

## Limits

- GFM tables have no merged cells, no multi-line cells and need a header row; with the header option off an empty header row is written.
- Cell formatting from the spreadsheet (bold, colours, links) is not copied, only the text.
- Column padding is for reading the source; renderers ignore it, and some fonts still show a few characters at other widths.

## Questions

### How do I make a table in Markdown?

Write a header row with cells split by |, then a row of dashes such as | --- | --- |, then one line per row. Or paste your data here and copy the result.

### How do I align columns in a Markdown table?

Put colons in the delimiter row: :--- for left, :---: for center and ---: for right. In the tool, use the alignment buttons for each column.

### How do I convert Excel to a Markdown table?

Select the cells in Excel or Google Sheets, copy them, and paste them into the tool. The clipboard carries them as tab-separated text, which the tool reads directly.

### How do I add a line break inside a Markdown table cell?

Use <br>. GitHub and most renderers show it as a new line inside the cell; a real line break would end the row.

### How do I put a pipe character in a Markdown table?

Escape it with a backslash as \| so it is not read as a column border. The tool escapes pipes in your cells for you.

### Can a Markdown table have merged cells?

Not in GitHub Flavored Markdown. If you need merged cells, write the table in HTML; GitHub renders basic HTML tables in Markdown files.
