ToolHub

Markdown Table Generator

Build Markdown tables visually

Markdown Table Generator
Columns3
Rows3

Generates valid GitHub-flavored Markdown tables. The alignment row uses :--- for left, :---: for center, and ---: for right. Pipe characters in your cells are escaped automatically. Everything runs in your browser.

Overview

Build GitHub-flavored Markdown tables visually

Markdown tables are powerful but fiddly to write by hand. You have to line up pipes, remember the divider row of dashes, and get the colons right for alignment. One misplaced pipe and the whole table collapses into a row of broken text. A visual generator removes that friction: you fill in a grid of cells and the correct Markdown is written for you.

ToolHub Markdown Table Generator gives you a spreadsheet-style editor where the first row is the header. Add or remove columns and rows, set per-column alignment, and watch valid GitHub-flavored Markdown appear live. You can also paste CSV or TSV to fill the grid in one step. Everything happens in your browser.

Step-by-step

How to generate a Markdown table

  1. 1

    Size your table

    Use the column and row controls in the header to add or remove cells. The grid starts at 3 columns by 3 rows, with the first row reserved as the header.
  2. 2

    Fill in the cells

    Click any cell and type. Set each column to left, center, or right alignment using the selector at the top of the column. Or paste CSV or TSV into the box and click Fill grid from paste.
  3. 3

    Copy the Markdown

    The generated table updates live in the output box. Click copy and paste it into GitHub, GitLab, a README, or any Markdown editor.

Background

How Markdown tables work

A Markdown table is just three kinds of lines. The first line is the header row, with cells separated by pipe characters. The second line is the divider row of dashes that tells the renderer this is a table. Every line after that is a body row. Columns do not need to be the same visual width in the source; the renderer aligns them for you.

The alignment row

Column alignment is controlled by where you put colons in the divider row. Use :--- for left, :---: for center, and ---: for right. This tool writes those markers for you based on each column's alignment selector, so you never have to remember the syntax.

Escaping pipes

A literal pipe character inside a cell would be read as a column break and shatter your table. The generator automatically escapes pipes as \|so text like “cats & dogs | other” stays inside its cell. Line breaks inside a cell are collapsed to spaces, since Markdown table cells are single-line.

Use cases

When to use a Markdown table generator

README documentation

Lay out configuration options, CLI flags, or feature comparisons in a clean table inside your project README.

GitHub issues and PRs

Summarize test results, checklists, or before-and-after values in a tidy table that renders on GitHub.

Converting spreadsheets

Paste CSV or TSV exported from Excel or Google Sheets and turn it into a Markdown table instantly.

Technical blog posts

Many static site generators and CMS platforms render Markdown, so tables drop straight into your writing.

API and data docs

Document request parameters, response fields, and status codes in aligned, readable tables.

Notes and wikis

Tools like Obsidian, Notion, and many wikis accept Markdown, making generated tables portable everywhere.

Tips and best practices

  • Keep header cells short. Long headers make the rendered table wide and hard to scan.
  • Use right alignment for numeric columns so digits line up by place value.
  • Paste CSV or TSV to skip manual entry, then tidy up cells in the grid.
  • You do not need to pad cells with spaces in the source. The renderer handles alignment.
  • Pipes inside cells are escaped automatically, so paste real-world text without worry.

Common questions

Will this work outside of GitHub?

Yes. The output is standard GitHub-flavored Markdown, which is supported by GitLab, Bitbucket, Obsidian, Notion imports, static site generators, and most Markdown editors. A few minimal Markdown renderers do not support tables at all, but they are rare.

What is the difference between CSV and TSV?

CSV separates fields with commas, while TSV separates them with tabs. The importer detects tabs automatically and otherwise treats the data as comma-separated, including handling quoted fields that contain commas.

Can columns have different alignments?

Yes. Each column has its own left, center, or right selector at the top of the grid, and the divider row reflects each choice independently.

Do empty cells break the table?

No. Empty cells render as blank table cells, which is valid. The table structure depends on the pipes and the divider row, not on every cell being filled.

100% private

Privacy and security

Your table content never leaves your device. The grid editor, CSV parsing, and Markdown generation all run locally in your browser. Nothing is uploaded or stored.

Related tools

Frequently asked questions

What format does it output?

Standard GitHub-flavored Markdown, which works in READMEs, GitHub, GitLab, and most Markdown editors.

Can I set column alignment?

Yes. Choose left, center, or right per column and the divider row updates with the correct markers.

Can I paste existing data?

Yes. Paste CSV or TSV and the grid fills in automatically.