Table markdown

In card description and comments you can create tables by using markdown.
The markdown syntax TCO uses is based on the Extended Syntax used by lots of markdown processors, so if Trello decides to implement the feature itself your TCO tables should display fine.



When you paste text in a card description or a comment, TCO will try to find out if the text contains formatting (for instance when copying and pasting from Excel) or a tab delimited table format (for instance from text files).
Formatted tables will automatically be transformed to TCO’s table markdown format.
If you paste plain text and a tab delimited format is detected TCO will give you the option to convert the text automatically to TCO’s table markdown format.
If you choose not to accept this TCO will convert each tab to 4 spaces, which is also what TCO inserts when you press the TAB key.
The TCO table markdown format is described below:

The minimal table has a header row, a column definitions row and 2 content rows with a minimum of 2 columns, separated as follows:

If a table contains only 2 columns, the header row must end with a |
For tables with 3 columns or more, the last | in the header row is optional.
The result of the above markdown is:

header 1	header 2
col 1	col 2
col 1	col 2

The header row is colored light blue, and content rows are shown with alternating white and gray row colors.

---

Full width

If you want the table to stretch the full card width, put a | at the end of the last column in the column definitions row:

The result is:

header 1	header 2
col 1	col 2
col 1	col 2

---

Controlling alignment

The default alignment is centered for headers and left for row cells.
You can change default alignment bij using |: or :|
Setting alignment in the cells of the column definitions row (the one with the — in it) changes header as well as row cell alignment.
You can override header or row cell alignment separately by using the : in the header or row cell.

The result is:

header1	header 2
col 1	col 2
col 1	col 2

---

Controlling cellspan

If you want a header or row cell to span more than 1 column, you can use multiple pipes.
The | at the end of the last column is optional.

The result is:

header1	header 2
col 1 spanning col 2
col 1	col 2

---

Multiple lines per cell

If you want text with linebreaks in a header or row cell, use \n.

The result is:

header1	header 2
col 1 spanning col 2
col 1	col 2

---

Prevent text wrapping

You can prevent text wrapping with a = directly after the | or |:
This can also be set as a default in the column definitions row, or per header or row cell separately.

The result has only effect if the text for all columns on a row is too long:

header1	header 2
we dont want col 1 text to wrap so we put a = in the column	text in col 2 may wrap
col 1	col 2

---

Set background colors for cells

You can set the background colors for a cell or all cells in a column with the c:colornameorhexvalue markdown.
This can be set as a default in the column definitions row, or per header or row cell separately.

The result is:

Column1	Column 2	Column 3
White text	Cyan cell	normal cell
normal cell	right cell	Yellow cell
normal cell	normal cell	normal cell

Tables are set to a maximum height of 250px, and will show a vertical scrollbar if the table has too many rows to fit in that space.
The table will also show a horizontal scrollbar if the minimum row width doesn’t fit.
If you click on the table header the whole table is shown at once without a vertical scrollbar.