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:
| header1 | header 2 |↵
| --- | --- ↵
| col 1 | col 2↵
| col 1 | col 2↵
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 |
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:| header1 | header 2 |↵
| --- | --- |↵
| col 1 | col 2↵
| col 1 | col 2↵
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.
| header1 |: header 2 |↵
| --- :|: --- :|↵
| col 1 | col 2 :|↵
|: col 1 | col 2↵
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.
| header1 |: header 2 |↵
| --- :|: --- :|↵
|: col 1 spanning col 2 :||↵
|: col 1 | col 2↵
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.| header1 |: header 2 |↵
| --- :|: --- :|↵
|: col 1 \n spanning \n col 2 :||↵
|: col 1 | col 2↵
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.
| header1 |: header 2 |↵
| --- :|: --- :|↵
|:= we dont want col 1 text to wrap \n so we put a = in the column | text in col 2 may wrap|↵
|: col 1 | col 2↵
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.
| Column1 | *Column 2* | Column 3 |↵
| --- |:--- c:cyan :| --- |↵
| c:black :| Cyan cell | normal cell↵
| normal cell | c:transparant right cell :| c:yellow Yellow cell↵
| normal cell | **normal cell** | *normal cell*↵
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.