MDUtil

Markdown Table Generator

Type or paste your data into the grid and get a clean Markdown table for GitHub, README files and documentation. Cells copied from Excel or Google Sheets paste straight in.

Table

| Fruit  | Color    | Price |
| ------ | -------- | ----- |
| Apple  | Red      | 1.20  |
| Banana | Yellow   | 0.50  |
| Cherry | Dark red | 4.80  |

How to make a table in Markdown

  1. Fill the grid

    Type into the cells, or copy a range from Excel, Google Sheets or Numbers and paste it into the first cell.

  2. Set the alignment

    Use the buttons above each column to align it left, center or right; the separator row's colons follow.

  3. Copy the table

    Copy the Markdown, or switch to HTML, CSV or LaTeX for the same table.

What it handles

Paste from spreadsheets
A range copied from Excel, Google Sheets or Numbers fills the grid from the cell you paste into, adding rows and columns as needed.
Pipes that line up
Cells are padded so the pipes line up in an editor, with Chinese and Japanese characters counted as double width.
Column alignment
Left, center and right alignment write :--, :-: and --: in the separator row.
Cells that never break the table
Pipes inside cells are escaped as \| and line breaks become <br>.
Four formats
The same table as Markdown, HTML, CSV or a LaTeX tabular with booktabs rules.
Edit existing tables
Open a .csv, .tsv or .md file to change a table you already have.

Markdown table syntax

A Markdown table is a header row, a separator row of dashes and any number of body rows, with pipes between the cells:

| Fruit  | Color  | Price |
| :----- | :----: | ----: |
| Apple  | Red    | 1.20  |
| Banana | Yellow | 0.50  |
  • The separator row needs at least three dashes per column, and colons set the alignment: :--- left, :---: center, ---: right.
  • The pipes at the start and end of a row are optional, and the columns do not have to line up.
  • Cells can hold inline formatting such as **bold**, `code` and links.
  • Write a pipe inside a cell as \| and a line break as <br>.
  • Markdown tables have no merged cells or multi-line rows; use an HTML <table> for those.

Tables are part of GitHub Flavored Markdown, so they work on GitHub and GitLab and in VS Code, Obsidian, Notion and Typora, though not in the original Markdown.

Questions and answers

How do I make a table in Markdown?

Write a header row, a separator row of dashes and the body rows, with pipes between the cells, or build the table in the grid above and copy the result. The syntax is explained above.

How do I convert an Excel sheet to a Markdown table?

Select the cells in Excel, copy them, click the first cell of the grid and paste. To convert a whole file, open it in the CSV to Markdown converter, which also reads .xlsx.

How do I align a column?

Add colons to the separator row: :--- for left, :---: for center and ---: for right, or use the buttons above each column of the grid.

Can a cell contain a line break or a pipe?

Yes. Write <br> for a line break and \| for a pipe; the generator does both for you.

Can I merge cells?

No. Markdown tables have no merged cells, but GitHub and most renderers accept an HTML <table> with colspan and rowspan. Switch the output to HTML to start from one.

Do Markdown tables work on GitHub?

Yes. Tables are part of GitHub Flavored Markdown and render in READMEs, issues, pull requests and wikis.