.MD Champ
← All guides

Markdown tables and formatting

Markdown tables use vertical bars to separate columns. A row of dashes beneath the headings tells the reader where the table starts.

Copy this two-column example

| Task | Status |
| --- | --- |
| Draft outline | Done |
| Review copy | In progress |

The first line defines the column headings. The second line separates headings from rows. Each following line is one row. In the formatted view it appears like this:

TaskStatus
Draft outlineDone
Review copyIn progress

Align columns and fix errors

Wide tables can scroll sideways in the reader on smaller screens. Keep cell text short when you can, and use headings to explain the table's purpose.

Read a Markdown file

Need to change a table? See the editing guide.