How to Make a Markdown Table: Step-by-Step Guide

To make a Markdown table, add your columns and rows, type into each cell, and choose an alignment per column — a tool then writes the pipes and dashes for you as valid GitHub-flavored Markdown you can paste straight into a README or issue. Doing it in a visual grid removes the fiddly manual formatting that makes hand-written tables error-prone.

This guide walks through building a table with the Markdown Table Generator, which runs entirely in your browser so your documentation never leaves your device.

What a Markdown table needs

A GitHub-flavored Markdown (GFM) table has three parts: a header row, a separator row of dashes, and one or more body rows, all delimited by pipe (|) characters. The separator row is also where alignment lives — colons control whether a column reads left, center or right. Getting those colons and pipe counts right by hand is exactly where mistakes creep in, which is why generating the markup is faster and safer.

Step-by-step: building your table

1. Add columns and rows. Use the add controls to size the grid to your data, then remove any you do not need.
2. Type into each cell. The first row is your header; the rest form the body. The Markdown output updates live as you type.
3. Set alignment per column. Choose left, center or right; the tool writes the matching colon markers in the separator row.
4. Copy or download. Copy the generated Markdown to your clipboard, or download it as a .md file for your repo.

Importing existing data from CSV or TSV

If your data already lives in a spreadsheet, you do not have to retype it. Paste CSV or TSV into the seed box and click Load into grid — the first row becomes the header, the remaining rows fill the body, and the delimiter is detected automatically. This is the fastest path from a spreadsheet export to a clean Markdown table.

How alignment markers work

Alignment	Separator syntax	Result in the column
Left	:---	Text hugs the left edge
Center	:---:	Text is centered
Right	---:	Text hugs the right edge (great for numbers)

You pick the alignment visually and the tool writes these markers for you, so you never have to remember which side the colon goes on. It also safely escapes pipe characters inside cells as \| and converts in-cell line breaks to <br>, both of which render correctly on GitHub and most Markdown viewers.

Why in-browser generation matters

Everything runs locally in JavaScript, so your notes, documentation and data are never uploaded or stored. That keeps internal docs and unpublished content private, and it means the tool keeps working offline once loaded — handy when you are drafting a README on the move.

Try the Markdown Table Generator — free and 100% in your browser.

FAQ

Will the table render the same on GitHub and GitLab?

Yes. The output is standard GitHub-flavored Markdown, which GitLab, most static-site generators and common Markdown viewers also support. The escaped pipes and <br> line breaks are handled consistently across these platforms.

Do I have to set alignment for every column?

No. Columns without an explicit alignment simply default to the viewer's standard left rendering. Set alignment only where it helps — right-aligning numeric columns is the most common case.

Can I add rows after importing a CSV?

Yes. Once the CSV seeds the grid, it behaves like any other table — add or remove rows and columns and edit cells freely. The Markdown output keeps updating as you go.

What happens if a cell contains a pipe character?

The tool escapes it as \| automatically so it displays as a literal pipe rather than breaking the table into extra columns. You can type pipes in your content without worrying about the structure.

Related free tools

• HTML Table Generator — build tables in HTML instead of Markdown.
• CSV Viewer & Table — preview CSV data as a table.
• CSV to JSON Converter — turn CSV into JSON.
• JSON to CSV Converter — flatten JSON back to CSV.

Built by ByteVancer

ByteTools is a free product of ByteVancer, a software and web development studio building web apps, SaaS and custom software. If your team needs custom developer tooling or documentation systems, explore what ByteVancer can build.