Skip to content

Markdown table generator

Type or paste cells, pick the alignment of each column and copy a clean Markdown table. It also makes HTML, text and LaTeX tables. Nothing leaves your browser.

RowColumnAlign the column
3 rows, 3 columnsSaved in this browser
Preview
The first row is the header. Click a column letter to select the column, then pick its alignment. Need a bigger table or a CSV file? Use the table editor or the CSV editor.

    Tools work on the selected cells or the selected column. Ctrl Z undoes them.
    Advertisement

    Last checked by the TextEditor.com team

    How to make a Markdown table

    1. Fill the gridType into the cells, or paste cells from Excel, Google Sheets, a CSV file or another Markdown table.
    2. Shape itAdd or move rows and columns. Select a column and pick left, center or right.
    3. CopyThe Markdown under the grid updates as you type. Click Copy and paste it into GitHub, a README file or your notes.

    The preview shows how the table will look once it is rendered. Your table is saved in this browser, so it is still here when you come back.

    Markdown table syntax

    Tables are not part of the original Markdown or of CommonMark. They come from GitHub Flavored Markdown (GFM), and most sites copied that rule set. The GFM specification describes them in its tables section.

    The three parts of a table 
    | Name  | Price | Stock |
| :---- | ----: | :---: |
| Tea   |  2.50 |   12  |
| Scone |  1.90 |    7  |
    1. Header row. One line, cells split by pipes. It is required, even when it is empty.
    2. Alignment row. At least three dashes per column. The colons set the alignment.
    3. Body rows. As many as you like. A short row gets empty cells, a long row loses the extra.

    The pipes at the start and end of a line are optional, and the spaces inside a cell do not matter. This tool pads the columns so the text lines up in a plain text editor too. Turn off "Padded columns" for the shortest form.

    How the alignment row works

    A colon on the left of the dashes aligns the column left, a colon on the right aligns it right, and one on each side centers it. With no colon, the reader's default applies, which is left on GitHub. The alignment applies to the header cell too. Try it below.

    Pick an alignment and watch the row change 
    | Name  | Price | Stock |
| :---- | ----: | :---: |
| Tea   |  2.50 |  12   |
| Scone |  1.90 |   7   |
    NamePriceStock
    Tea2.5012
    Scone1.907

    Pipes, line breaks and other limits

    The pipe splits cells, so a pipe inside a cell must be written as \|. This tool does that for you. A cell cannot hold a line break. Pressing Enter in a cell ends the row. To show two lines in one cell, write <br> between them. GitHub renders it, and so do most other sites.

    Cells can hold inline Markdown: bold, italics, code and links. They cannot hold lists, headings or code blocks. Also, every row must sit on one line. A long table is easier to edit in the grid above than by hand.

    Where Markdown tables work

    PlaceTablesNote
    GitHub, GitLab, BitbucketYesIn README files, issues and comments
    Obsidian, Typora, Joplin, Notion importYesNotion turns the pasted text into its own table
    RedditYesIn Markdown mode. The rich text editor has its own table button.
    Stack OverflowYesAdded in 2021
    Discord, Slack, WhatsAppNoThey read only bold, italics and code. Paste a text table inside a code block instead.

    Checked October 2026. For chat apps, switch to the Text table tab. It draws the table with box lines, and inside a code block the columns stay lined up. The text frames page has more boxes for single lines of text.

    Paste from Excel or Google Sheets

    Select the cells in your spreadsheet and copy them. Click a cell in the grid above and press Ctrl+V. Copied cells arrive as tab separated text, so each one lands in its own cell. Number columns are aligned right by default when you paste. If the first row of your copy is not a header, add a row above it and type the names.

    For a whole file, open it in the CSV editor or the table editor and export it as Markdown there. To write the text around the table, use the Markdown editor with its live preview.

    Other table and Markdown tools

    Frequently asked questions

    How do I make a table in Markdown?

    Write the header cells on one line with pipes between them, then a line of dashes for each column, then one line per row. Or fill the grid above and copy the result. The output updates as you type.

    How do I align a column in a Markdown table?

    Put a colon in the dash row: :--- for left, ---: for right and :---: for center. In the tool, click a column letter, then one of the Align buttons.

    How do I put a pipe in a Markdown table cell?

    Write it as \|. Inside code in a cell, GitHub still needs the backslash. The tool adds it for you. Turn off "Escape pipes" if your site does not read it.

    Can a cell have more than one line?

    Not with a real line break. Write <br> where the line should break. GitHub and most Markdown editors render it. Alt+Enter in a grid cell here adds one for you.

    Does Discord support Markdown tables?

    No. Discord reads bold, italics, code and a few other marks, but not tables. Use the Text table tab here and paste the result inside a code block with three backticks on each side.

    • Text editorWrite and edit plain text in your browser.
    • Code editorWrite or paste HTML, CSS, JavaScript, JSON, Python, SQL and more with colors, line numbers and a format button.
    • JSON editorPaste JSON to format, minify or check it.
    • Sort linesSort lines A to Z, by number or by length.
    • ASCII tableAll 128 ASCII codes with decimal, hex, octal, binary and HTML values.
    • Text framesPut a box, border or ASCII art frame around your text.

    ↑ ↓ to choose, Enter to open, Esc to close