06 / Markdown / markdown-table-generator

Markdown Table Generator

Build Markdown tables with alignment.

ReadyLocal processing
06 · Workspace

How to use

  1. 01Set the number of Columns (1–12) and Rows (1–50).
  2. 02Type your column names into the header inputs at the top of the grid.
  3. 03Choose Left, Center or Right alignment for each column from the dropdown under its header.
  4. 04Fill in the body cells. The Markdown table output updates as you type.
  5. 05Click Copy to copy the table, or Download .md to save it as table.md.

What is this tool?

The Markdown Table Generator lets you build a table in a spreadsheet-like grid instead of counting pipes and dashes by hand. It writes valid GitHub Flavored Markdown with alignment markers, pads the columns so the source text lines up, and escapes any pipe characters in your cells. It runs locally in your browser.

Markdown table syntax and column alignment

A Markdown table is a header row, a separator row and any number of body rows, with cells separated by the pipe character. The separator row sets each column's alignment: :--- is left, :---: is centered and ---: is right-aligned.

For example, a table with a left-aligned Name column and a right-aligned Price column has the separator | :---- | ----: |. The generator writes these markers from the dropdowns, so you never need to remember which side the colon goes on.

Escaping pipes and aligning the source

A literal pipe inside a cell, such as "true | false", would normally split the cell in two. The generator escapes every pipe as \| so the value stays in one cell.

It also pads each cell with spaces to the width of the widest value in its column, following that column's alignment. Renderers ignore the extra spaces, but the source is much easier to read in a diff or a code review.

Resizing a table

Raising the column or row count adds empty cells and keeps what you've typed. New columns get a placeholder header like "Column 4" and default to left alignment. Lowering a count removes the last columns or rows along with their contents, so copy anything you need first.

Common use cases

  • Adding feature or compatibility matrices to a README
  • Summarizing test results by case, status and owner in a test report
  • Building comparison tables for pull request descriptions
  • Documenting API parameters, types and defaults
  • Creating environment or configuration reference tables in docs

FAQ

How do you align columns in a Markdown table?

Put colons in the separator row: :--- for left, :---: for center and ---: for right. The generator adds them based on the alignment you pick for each column.

How do I put a pipe character inside a Markdown table cell?

Escape it as \|. The generator does this for you automatically.

How many rows and columns can I create?

Up to 12 columns and 50 body rows, plus the header row.

Will the table work on GitHub?

Yes. The output is a standard GitHub Flavored Markdown pipe table, which GitHub, GitLab and most Markdown renderers support.

What happens to my data if I reduce the number of columns?

The columns on the right are removed along with their contents. Adding them back gives you empty cells.