Using Configuration Commands

With Deckset configuration commands we provide a way to control how your presentation looks and works. Specifically, you get control over content scaling, lists building in, slide numbers and footers.

Each command can be applied in two ways, either globally to effect the whole presentation or per slide to set something new or override global settings.

Let’s take a look at the structure and positioning of commands before going through each possibility in detail.

Global Commands

Global commands are set on the first few lines of your Markdown file (e.g. autoscale: true). When using, be sure that there are no line breaks between any other commands at the top of your Markdown file.

Placing global configuration commands at the top of your Markdown file

All commands are ‘off’ or ‘false’ globally by default, so you only need to add ‘true’ to each to turn them on to affect all slides.

All Possible commands turned on

Per Slide Commands

On individual slides you can turn commands on or override and turn off a globally set command, to do this the command is inserted on a new line and wrapped in two square brackets with a preceding dot. ‘True’ turns a command on: [.autoscale: true]

Turning commands on per slide

‘False’ turns a globally set command off: [.autoscale: false].

Overriding globally set autoscale — In this case you can see the content no longer fits on the slide.


At times you have to fit more content onto one slide than the default font sizes allow for, Deckset’s autoscale command allows you to fit more text in by scaling the text down.

Globally this is enabled by including the autoscale: true command at the top of your Markdown file. This is best for cases where you have a really text heavy presentation, these might be for printing or work like hand-outs rather than being projected.

Applying a global Autoscale command allows you to fit a lot more on each slide

Sometimes there is just a little more information that needs to fit on one slide, which is a perfect use for applying [.autoscale: true] to a single slide.

Although it is a rare case, you can turn autoscale off on a particular slide when it is applied globally by adding [.autoscale: false] on the respective slide.

Build lists

When presenting a list of information, you may want each item to appear one by one. To achieve this with Deckset, use the build-lists: true command.

When added to your presentation, the preview in Deckset looks the same, but when using the Presenter and Rehearsal mode you can see the list build in step-by-step.

A list in Deckset

The presenter view, building a list in

You may turn this on or off on an individual slide by declaring [.build-lists: true] or [.build-lists: false] on the respective slide.

Slide numbers

To add running slide numbers to your presentation use the slidenumbers: true command. This will add them everywhere including full image slides and titles.

All Slides with slide numbers

You may turn this on or off on an individual slide by declaring [.slidenumbers: true] or [.slidenumbers: false] on the respective slide. This would help remove clutter and create focus on dramatic slides.

Removing slide numbers on select slides


To add a persistent footer to each slide of your presentation, use the footer: My Footer command.

A globally applied persistent footer

To override your global footer or to add a footer to a single slide, add [.footer: A different footer] to the respective slide.

Adding a footer to a single slide

You may turn off the footer on an individual slide by declaring [.hide-footer] on the respective slide. This is again great for image-only slides or ones where you want to make a big point without distraction.

Removing a global footer

Storing your theme choice

Deckset does store the theme choice as metadata to the file, but in some cases, this information can get lost, e.g. in version control systems or when sending the file via email.

To make sure the theme choice doesn’t get lost, you can use the following command theme: Merriweather.

If you also want to specify the color choice, you can reference the number of the color swatch as it appears within Deckset e.g.: theme: Merriweather, 4

Please note that this command is a global command, needing to be applied at the top of your Markdown file.

Specifying a theme

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

Working with tables

How to use Ulysses with Deckset

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