Cheat sheet


    # Use Headings
    Combine headings with paragraph text and other elements like lists:
    - It's super quick.
    - It's super easy.
    # Separating Slides
    To start a new slide, simply put three dashes (`---`) on a single line, with an empty line above and below.
    # Paragraphs
    Use a blank line in between text to start a new paragraph.
    You can include a paragraph break by leaving an empty line between the paragraphs.
    Otherwise lines will follow on directly like this.


    # Large Heading
    ## Regular Heading
    ### Small Heading
    #### Tiny Heading
    ## Combine Headings
    ### Of Different Sizes
    # [fit] Make Headings Fit Onto
    # [fit] The Slide


    # Unordered Lists
    - Start each bullet point
    - with a dash to create
    - an unordered list
    # Ordered Lists
    1. Start each item with
    1. a number followed by a dot
    1. to create an ordered list
    # Nested Lists
    - You can create nested lists
        1. by indenting
        1. each item with
        1. 4 spaces
    - It's that simple

    Text Styles

    # Asterisk Emphasis
    Use single asterisks around text to *emphasise it*.
    Or use double asterisks for an **strong emphasis** style.
    # Underscore Emphasis
    Alternatively, you can also use underscores to emphasize:
    Wrap text in single underscores to _emphasize it_. Or use double underscores for the alternative __strong emphasis style__.
    # Combined Emphasis
    Combining underscores with asterisks lets us mix and match the emphasis styles. Play with it — some themes have additional style options for those combinations:
    - _**Style 1**_
    - __*Style 2*__
    - __**Style 3**__
    # The same *styles* work in **headings**, too.
    # More Styles
    - ~~Strikethrough~~
    - Super<sup>script</sup>
    - Sub<sub>script</sub>
    - `Inline code`


    > The best way to predict the future is to invent it
    -- Alan Kay
    # Inline Quotes
    You can also use a quote together with paragraph text or other elements on the slide:
    > The best way to predict the future is to invent it
    -- Alan Kay
    Prefix the author of the quote with `--`, or leave it out if it's anonymous.

    Background Images

    # Text on Images
    Setting text on images applies a filter to the image to make the text more readable.
    # Disable Filter
    ![original 250%](image2.jpg)
    # Zoom In
    # Split Slides
    Use the `left` or `right` modifiers to place the image in the left or right half of the slide, respectively.
    ![left filtered](image1.jpg)
    # Force Apply Filter
    Use the `filtered` keyword to apply the theme's filter to an image that isn't filtered by default.
    ![right fit](image2.jpg)
    # Split Slides
    Combine `left` or `right` with the `fit` keyword or a percentage to adjust the image scaling.

    Inline Images

    # Combine Text and Images
    # Fill the Slide
    ![inline fill](image1.jpg)
    # Custom Scaling
    ![inline 50%](image1.jpg)
    # Image Grids
    ![inline fill](image1.jpg)![inline fill](image2.jpg)
    ![inline fill](image3.jpg)


    # Inline Videos
    # YouTube Embeds!
    You can also use URL parameters like `?t=30s` to specify a start time for the clip.
    # Video Layout Control
    Use the same layout modifiers as with images to control the positioning of videos.
    - `left` and `right`
    - `fit` and `fill`
    - Percentage sizing, e.g. `50%`
    ![right autoplay mute](
    # Video Playback Control
    Control video playback by using one of those directives:
    - `autoplay`
    - `loop`
    - `mute`

    Code Blocks

    # Syntax Highlighting
    Use GitHub style fenced code blocks to specify the language.
      url: "/api/getWeather",
      data: {
        zipcode: 97201
      success: function( data ) {
        $( "#weather-temp" ).html( "<strong>" + data + "</strong> degrees" );
    # Automatic Scaling
    Don't worry if your code is slightly too long. Deckset scales code blocks to fit automatically.
    def establish_connection(spec = nil)
      spec     ||=
      resolver = configurations
      spec     =   resolver.spec(spec)
      unless respond_to?(spec.adapter_method)
        raise AdapterNotFound, "database configuration specifies nonexistent #{spec.config[:adapter]} adapter"
      connection_handler.establish_connection self, spec
    # Inline `code`
    Use code within normal text by enclosing it in backticks.
    For example: `func map<A, B>(x: A?, f: A -> B) -> B?`

    Presenter Notes

    # Presenter Notes
    Deckset turns every paragraph that starts with a `^` into presenter notes and doesn't show this text on the slides.
    ^ This is how you create a presenter note. You'll see it on the presenter display (with two screens connected) or by using the rehearsal mode.
    ^ To start another presenter note paragraph, prefix it with a caret again. Deckset will automatically scale the notes down to fit onto the presenter display in case you have a lot of text.

    Footers and Slide Numbers

    footer: © Unsigned Integer UG, 2014
    slidenumbers: true
    # Footers and Slide Numbers
    Include persistent custom footers and/or running slide numbers by inserting the following directives at the *very top* of your file:
    `footer: © Unsigned Integer UG, 2014`
    `slidenumbers: true`
    Make sure that there are *no empty lines* between the two.
    footer: Use *emphasis* and ~~other~~ text styles if you like
    # Text Styles in Footer Text
    You can use standard text styles such as emphasis in your footer text, just as you would in other places too.


    # Link to External Resources
    In case you're looking for something, you could use [Google]( or [Wikipedia](
    Links will be clickable in exported PDFs as well!
    # Links Between Slides
    Define an anchor on the slide you want to link to using standard HTML syntax:
    `<a name="link-target"/>`
    Then you can link to this [slide](#link-target) easily.


    # Footnotes
    Footnotes are a breeze, for example:
    Most of the time, you should adhere to the APA citation style[^1].
    Note that footnote references have to be *unique in the markdown file*. This means, that you can also reference footnotes from any slide, no matter where they are defined.
    [^1]: For more details on the citation guidelines of the American Psychological Association check out their [website](
    # Named References
    Instead of just numbers, you can also name your footnote references[^Wiles, 1995].
    [^Wiles, 1995]: [Modular elliptic curves and Fermat's Last Theorem]( Annals of Mathematics 141 (3): 443–551.


    # Formulas
    Easily include mathematical formulas by enclosing TeX commands in `$$` delimiters. Deckset uses [MathJax]( to translate TeX commands into beautiful vector graphics.
    \left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
    # Inline $$Formulas$$
    You can also include Formulas in paragraph text. Deckset takes care of adjusting the font size and color to match the surrounding text, for example:
    The slope $$a$$ of the line defined by the function $$f(x) = 2x$$ is $$a = 2$$.
    # Formula Autoscaling
    Don't worry if your equations get really complex. Deckset will scale them down to fit onto the slide.
    1 +  \frac{q^2}{(1-q)}+\frac{q^6}{(1-q)(1-q^2)}+\cdots =
    \quad\quad \text{for $|q|<1$}.


    # Use Emojis :+1:
    Deckset supports GitHub style emojis: :tada: :umbrella: :sunflower: :cat: :smile:

    Please refer to this Emoji Reference Markdown file to see which emoji are supported in Deckset. There are a few favourites that aren’t in unicode so we cannot support them.

    Controlling Line Breaks

    # Controlling Line Breaks
    In paragraph text, Deckset respects when you start a
    This can come in handy in situations where you need more control over how text is broken up into multiple lines.
    # Use `<br>` for<br>line<br>breaks
    You can use the HTML tag `<br>` to insert line breaks in elements that cannot contain regular new lines, such as headings or footers.

    Scale content to fit the slide

    At times you have to fit more content onto one slide than the default font sizes allow for.

    Deckset comes with an option to auto-scale paragraph text, lists, and other body content down to fit onto the slide. To enable this behavior put

    autoscale: true

    at the top of your markdown file. (Make sure that there are *no empty lines* between any other directives at the top of your markdown file.)

    Build Steps

    In Presenter and Rehearsal mode, you may want list items to appear one by one. To achieve this with Deckset, put

    build-lists: true

    at the top of your markdown file. (Make sure that there are *no empty lines* between any other directives at the top of your markdown file.)

    Please note that this only affects Presenter (and Rehearsal) mode.

    Store theme choice in document

    Deckset does store the theme choice as metadata to the file. 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 include it at the top of your Markdown file by adding

    theme: Fira

    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: Fira, 3

    Hide slides

    If you want to prevent particular slides (or pieces of content) from being presented but want to keep them in your document, you can do it like this:

      This slide will be hidden.