Working with tables

Step 1: Creating table headers

Begin by writing out the headers for each column separated by pipe characters |. Pipes at the start and end of the line are optional.

Columns are defined by pipes

To define these as headers and begin a table that can be interpreted by Deckset, you add a second line, matching the number of pipes, and using at least 3 hyphens in place of the header text.

Headers are defined by a row of pipe characters, separated by hyphens

When the Markdown file is open in Deckset you can see a table is beginning to take shape.

The beginnings of a table

If you add more columns, Deckset automatically divides the available space evenly between the quantity of columns you include.

Adding more columns

Step 2: Adding rows

Now that the basic structure is in place, you can add rows of cells. Each row begins on a new line, with each cell being separated by a pipe. If your text wraps onto multiple lines in your Markdown file this will not effect the display of your table in Deckset.

Adding rows of table content

At this point it may be helpful to set your editor to use a mono-spaced font and structure your Markdown file to align the pipe characters to get a better feel for your table. The display in Deckset will not be effected by these adjustments to make the file a little easier to work with. However, this is entirely optional.

Optional: Reformatting the Markdown file for easier reading

Step 3: Aligning cells in a table

All tables are left aligned by default, adding colons : to the row of Markdown containing the hyphens changes the text alignment in a column.

To center content add colons to either side of the hyphens :—: or to right align place a single colon to the right of the hyphens—:.

Right aligned third and fourth column

Step 4: Styling cells

Table headings are always bold, and can be given emphasis. Table cells can be styled with both emphasis and strong. You can also add headings to the slide to introduce or frame your table. And don’t forget the emojis.

Styling Cells with Bold and Emphasis

Step 5: Generating tables faster

Complex Markdown tables can become fiddly to work with, but thankfully there are a few tools out there to make your life easier, be it creating a table from scratch or converting something you are already working with.

The most comprehensive solution for working with Markdown tables is Table Flip, it’s fast and generates a Markdown file, so you can edit from within the app or in the Markdown file itself and both stay in sync.

Table Flip

tablesgenerator.com is a neat browser-based option to convert files or create simple tables from scratch and convert to Markdown.


Another browser option for converting and editing Markdown tables is Table Editor 2 by Peder Skeidsvoll.

Table Editor 2

Go forth and create tables! We will keep improving how Deckset works so it can better handle more complex tables in the future.

We hope you enjoyed this tutorial and learned something new. Feel free to share your ideas or comments via support@decksetapp.com.

See more of our tutorials

How to make your first presentation with Deckset

Using Configuration Commands

How to use Ulysses with Deckset

Sign up to receive updates, offers and beta
invites for upcoming releases.