Fetching contributors…
Cannot retrieve contributors at this time
461 lines (291 sloc) 9.78 KB

# Deckset Tutorial

## How to use Markdown to make beautiful presentations

Open this file in your favorite text editor and in the Deckset application. I recommend that you view the tutorial using the Plain Jane theme to start with, as not all themes support all styling options. You can switch back and forth between editor and app to see how the Markdown is converted into slides, making experimental adjustments as you see fit. Or, if you tell Deckset which editor you like to use, it will provide a picture-in-picture window for you (GUI editors only). Enjoy.

^ Note: if you are viewing this file on GitHub, everything after this point will look weird.

or

or

# Steven Syrek

steven.syrek@gmail.com

steven.syrek@gmail.com

steven.syrek@gmail.com

## Smart copy & paste

To copy a slide from Deckset to another document, just ⌘+C it, then ⌘+V it into your editor (it will paste the Markdown) or into any application that handles PDFs (it will paste the slide as PDF).

# You can include inspirational quotes

You miss 100 percent of the shots you never take. -- Wayne Gretzky

Or (this one is inline) quotes that are actually interesting:

-- Louis C. K.

# You can also include notes for yourself in the Markdown file that won't display on the slide

^ This text will not appear on the slide.

# Line breaks

Put your line breaks wherever you want

# Emojis

You can use GitHub style emojis:

💩 😡 🔥 😱 👎 😾 👸 😋 😅 🐹 🌺 🍉

1. Ordered list
2. Use a 1 on every line
3. And they will be given the correct sequence
• Unordered list
• Use any of these three characters
• And you will get a bulleted list

• Nested lists are also possible
1. indent each item 4 spaces
• here's another nested list
2. back to this level
3. and another item
1. a numbered list, nested
2. another nested item
• And back to the top

You embolden text like this or like this You emphasize text like this or like this Or do both at the same time You can also strikethrough text

This is Subscript text This is Superscript text

Center text like this

You can write code inline by using backticks. For example, if you want to mention in passing that the monadic bind operation in Haskell has the type signature (>>=) :: forall a b. m a -> (a -> m b) -> m b.

Or you can use code blocks for longer examples, which use triple backticks and support syntax highlighting (as on GitHub):

instance Functor Maybe where
fmap _ Nothing      = Nothing
fmap f (Just a)     = Just (f a)

instance Applicative Maybe where
pure = Just

Just f  <*> m       = fmap f m
Nothing <*> _m      = Nothing

Just _m1 *> m2      = m2
Nothing  *> _m2     = Nothing

(Just x) >>= k      = k x
Nothing  >>= _      = Nothing

(>>) = (*>)

fail _              = Nothing

Yeah, yeah, I know you want to see JavaScript:

var docCookies = new Proxy(docCookies, {
get: function (oTarget, sKey) {
return oTarget[sKey] || oTarget.getItem(sKey) || undefined;
},
set: function (oTarget, sKey, vValue) {
if (sKey in oTarget) { return false; }
return oTarget.setItem(sKey, vValue);
},
deleteProperty: function (oTarget, sKey) {
if (sKey in oTarget) { return false; }
return oTarget.removeItem(sKey);
},
enumerate: function (oTarget, sKey) {
return oTarget.keys();
},
ownKeys: function (oTarget, sKey) {
return oTarget.keys();
},
has: function (oTarget, sKey) {
return sKey in oTarget || oTarget.hasItem(sKey);
},
defineProperty: function (oTarget, sKey, oDesc) {
if (oDesc && "value" in oDesc) { oTarget.setItem(sKey, oDesc.value); }
return oTarget;
},
getOwnPropertyDescriptor: function (oTarget, sKey) {
var vValue = oTarget.getItem(sKey);
return vValue ? {
value: vValue,
writable: true,
enumerable: true,
configurable: false
} : undefined;
},
});

# Slide with an image and text overlay, unfiltered

You can use the [inline] modifier to add a caption to your image like this

# You can also have images fill a slide (the default behavior), fit to a slide, scale up or down, align left or right, and appear filtered for a cool special effect (demonstrated on the following slides)

Images used inline scale to fit the size of the surrounding text:

You can also create rows of images (make sure to insert a blank line to create a new paragraph):

Or a grid:

Or a grid with space between the lines:

# You can have footnotes, too, if you must

This is some text that I would like to footnote[^1].

[^1]: This is the footnote (but do you really need footnotes on your slides?).

# Name references for footnotes, if you must

This is a reference to something[^Syrek, 2016].

[^Syrek, 2016]: I'm obviously not a fan of footnotes in slides.

# There is also support for math using

$$\LaTeX$$

Which, if you know how to use it, you are excited about:

$$\begin{matrix} \left( \frac{1 + x}{2 + y^{2}} \right)^{2} & \left[ \frac{1 + x}{2 + y^{2}} \right]^{2} & \left{ \frac{1 + x}{2 + y^{2}} \right}^{2} & \left| \frac{1 + x}{2 + y^{2}} \right|^{2} & \left| \frac{1 + x}{2 + y^{2}} \right|^{2} & \left\backslash \frac{1 + x}{2 + y^{2}} \right\backslash^{2} & \left/ \frac{1 + x}{2 + y^{2}} \right/^{2} & \left< \frac{1 + x}{2 + y^{2}} \right>^{2} &\ \left\lfloor \frac{1 + x}{2 + y^{2}} \right\rceil^{2} & \left\lceil \frac{1 + x}{2 + y^{2}} \right\rfloor^{2} & \left\ulcorner \frac{1 + x}{2 + y^{2}} \right\lrcorner^{2} & % not stretchy \left\llcorner \frac{1 + x}{2 + y^{2}} \right\urcorner^{2} & % not stretchy \left( \frac{1 + x}{2 + y^{2}} \right]^{2} & % mix and match \left\uparrow \frac{1 + x}{2 + y^{2}} \right\downarrow^{2} & % weird \left\Uparrow \frac{1 + x}{2 + y^{2}} \right\Downarrow^{2} & % weirder \left\updownarrow \frac{1 + x}{2 + y^{2}} \right\Updownarrow^{2} &\ % weirdest \left. \frac{1 + x}{2 + y^{2}} \right)^{2} & % no left delimiter \left( \frac{1 + x}{2 + y^{2}} \right.^{2} & % no right delimiter \left. \frac{1 + x}{2 + y^{2}} \right.^{2} % no delimiters at all \end{matrix}$$

You can also do inline formulas thusly: $$[(a * b) + (c * d)]^{2}$$

# You include certain directives at the very top of your file, to affect the entire deck:

• footer: footer: whatever you want your footer to be
• numbered slides: slidenumbers: true
• auto-fit all text onto slides: autoscale: true
• show list bullets one by one: build-lists: true

I'm not going to demonstrate this one, because it'll make all the other examples too noisy.