See this MSE post for the table formatting/syntax and limitations: New Feature: Table Support
Okay, so how do you use tables? We've updated our formatting
help to give you
some guidance. But here's an overview for you.
A simple table looks like this:
| A header | Another header |
| -------- | -------------- |
| First | row |
| Second | row |
You always need a header row
Cells are separated by a pipe (
You can include leading and trailing pipes but don't have to
A header row has to be followed by a separator row with the same amount of cells, and you can't have spaces between separators (
The amount of space and
- characters in a cell don't have to line up (but it sure looks nice if it does)
You can set the alignment of a table column by including a
: in the corresponding cell of the separator line. A
: on the left will make a column left-aligned (this is the default). A
: on the right will make it right-aligned. Both, left and right
:s will produce a center-aligned column.
| left | center | right |
|:---- |:------:| -----:|
| One | Two | Three |
Markdown tables come with a set of limitations. They don't support
everything you can do with HTML tables, and that's on purpose. Each
cell can only include inline content (text, images, links, inline
You can't merge cells or rows.
Block content like multiple paragraphs, lists, code blocks, sub-tables
and other complex stuff does not work. If you're trying to mix a
Markdown table with inline HTML, you might be up for a wild ride.
You can't manually determine the width of a column. Your browser will
decide what's a good width for any given column based on the content
in your table.
If you need more details, I recommend taking a peek at the
GitHub-flavored Markdown specification for