How to Create Tables in Markdown

You can totally create tables in Markdown. The syntax may seem overwhelming at first but it's not that complicated.

Want to create a table like this in Markdown?

Keys List
| Column separator
- Delimiter row to separate the header from the body
: For header alignment

It's not that complicated if you know the Markdown syntax. Let me show you how to add tables in Markdown.

Add tables using Markdown syntax

In typical Markdown, a table must have a header. The header is basically the first row that is highlighted in bold letters.

The header is separated from the rest of the rows with -:

|Header column 1|Header column 2|

There is no rule behind the number of -. You can just put one like this |-|-| and it will work the same. But keeping multiple ------ helps understand the table code better.

Once you have added the headers, adding the rows are simple. You just create columns in each row by keeping the text between |

|some text|more text|
|some text|more and longer text|

Now, if I combine it, the table code looks like this:

|Header column 1|Header column 2|
|some text|more text|
|some text|more and longer text|

And the rendered Markdown table looks like this:

Header column 1 Header column 2
some text more text
some text more and longer text

Did you notice that text in the header is center aligned? That's the default behavior. You can change it with the help of :.

In the header separator, use |:---| to make the column text left-aligned and |---:| to right-align it. You can force it to center aligned with |:---:|.

Here's another example. Click on it to enlarge it:

Adding tables in Markdown
Table in Markdown (click to enlarge) 

Other ways to create Markdown tables

Some Markdown editors allow adding tables in a graphical manner. That makes the job easier as it is not easy to remember the syntax for tables.

For example, the MarkText editor has an initutive interface that makes using Markdown easier.

Adding tables in Markdown with MarkText editor
Adding tables in Markdown with MarkText editor

You don't need to install a new Markdown editor just for tables though. You may also use online Markdown table generators. Just enter the content of the table and hit generate to get the Markdown code for your desired table.

Markdown Table Generator Online
Adding tables in Markdown using online tools

There are plenty of online Markdown editors to try.

Best Free Online Markdown Editors That Are Also Open Source
Markdown is a useful lightweight markup language and a lot of people prefer for writing documentation or web publishing. Many of us at It’s FOSS use markdown for writing our articles. There are several Markdown editors available for Linux that you can install and use. But, what if you

If you are new to it, please refer to our beginner's guide to Markdown.

Basic Markdown Syntax Explained [With Free Cheat Sheet]
Learning markdown could help you a lot with writing for web. Here’s a complete beginner’s guide to Markdown syntax with downloadable cheat sheet.

Let me know if you have any questions.

Become a Better Linux User

With the FOSS Weekly Newsletter, you learn useful Linux tips, discover applications, explore new distros and stay updated with the latest from Linux world


Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to It's FOSS.

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.