All articles

Markdown Tables: How to Make a Table the Easy Way

In Markdown, tables are drawn with symbols: columns are separated by a vertical bar |, and a line of dashes goes under the header. For a small table it's bearable, for a large one it's slow and tedious.

What a Markdown table looks like

| Name | Team    |
|------|---------|
| Anna | Sales   |
| John | Support |

The first row is the headers, the second is a line of dashes, then come the data. If you get even one dash wrong, the table may not display.

How to make a table in Gramax

  1. Open app.gram.ax and click Create New.
  2. Click the table icon on the editor toolbar.
  3. Fill in the cells. Rows and columns are added with buttons.

Gramax takes care of all the markup.

How to move a table from Excel

No need to retype a big table:

  1. Select the table in Excel or Google Sheets and copy it.
  2. Paste it into an article in Gramax.

The table builds itself, with all its rows and columns. Read more: how to move a table from Excel to Markdown.

What else tables in Gramax can do

  • Merge cells — you can't do that in regular Markdown.
  • Sort rows and filter values.
  • Calculate totals: sum, average, count.
  • Change column width and alignment with your mouse.

Read more in the tables documentation.

Frequently asked questions

Question

Answer

How do I make a table in Markdown?

The easiest way is the table button in Gramax. You fill in the cells like in Word, and the markup is created for you.

How do I paste a table from Excel?

Copy the table in Excel and paste it into an article in Gramax — it builds automatically.

Can I merge cells?

In regular Markdown — no. In Gramax — yes, in a couple of clicks.

Why doesn't my table display?

Most likely a bar or a dash is missing somewhere. To avoid hunting for the error, build the table in Gramax — you can't get it wrong there.

Other formatting rules — in the article what is Markdown.

Build a single knowledge base for your team today

Free for teams of any size. Runs in your browser — nothing to install.