Deckset Presentation Expert

Expert assistant for creating professional presentations using Deckset's markdown-based format.

What is Deckset?

Deckset transforms Markdown files into beautiful presentations. Write content in plain text, Deckset handles the design.

Quick Start

Basic Structure

# Presentation Title
## Subtitle

---

## First Slide

Content with **bold** and *italic*.

- Bullet one
- Bullet two

---

## Second Slide

More content.

Critical Rules

1. Slide Separators: --- MUST have blank lines before and after
2. Headings: # = title slide, ## = slide title, ### = subtitle
3. Images: ![](bg.jpg) = background, ![inline](pic.png) = inline
4. Presenter Notes: Start line with ^ (hidden from slides)
5. Config: Add at top before first slide

Core Syntax

Slide Separators

CRITICAL - Most common mistake:

Content

---

Next slide

Blank lines are REQUIRED above and below ---.

Headings

# Large (title slides)
## Regular (slide titles)
### Small (subtitles)

# [fit] Scale to Fit

See [docs/formatting/headings.md](docs/formatting/headings.md)

Lists

- Bullet point
  - Sub-point (2 spaces)

1. Numbered item
   1. Sub-item (3 spaces)

See [docs/formatting/lists.md](docs/formatting/lists.md)

Text Formatting

**bold** *italic* ***bold italic***
`code` ~~strikethrough~~

See [docs/formatting/text-styles.md](docs/formatting/text-styles.md)

Images

![](background.jpg)                      # Full-screen background
![inline](logo.png)                      # Inline with text
![inline fill](photo.jpg)                # Fill space
![inline 50%](image.png)                 # Custom size
![inline corner-radius(16)](pic.jpg)     # Rounded

See [docs/media/inline-images.md](docs/media/inline-images.md) and [docs/media/background-images.md](docs/media/background-images.md)

Code Blocks

````markdown

def hello():
    print("Hello")

````

See [docs/formatting/code-blocks.md](docs/formatting/code-blocks.md)

Presenter Notes

## Slide Title

Visible content

^ Presenter note (not visible on slide)
^ Start each note line with ^

See [docs/presenting/presenter-notes.md](docs/presenting/presenter-notes.md)

Videos

![](video.mp4)
![autoplay loop](video.mp4)
![mute autoplay loop](bg-video.mp4)

See [docs/media/videos.md](docs/media/videos.md)

Configuration

Add at the very top (before first slide):

theme: Plain Jane, 1
footer: © 2024 Company
slidenumbers: true
autoscale: true

---

# First Slide

See [docs/customization/configuration-commands.md](docs/customization/configuration-commands.md)

Advanced Features

Columns

[.column]
Left content

[.column]
Right content

See [docs/formatting/columns.md](docs/formatting/columns.md)

Formulas (LaTeX)

$E = mc^2$

Inline: $x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$

See [docs/formatting/formulas.md](docs/formatting/formulas.md)

Mermaid Diagrams

````markdown

graph LR
    A[Start] --> B{Decision}
    B -->|Yes| C[End]

````

See [docs/media/markdown-graphs.md](docs/media/markdown-graphs.md)

Build Steps

Lists reveal progressively. Enable with build-lists: true in config.

See [docs/presenting/build-steps.md](docs/presenting/build-steps.md)

Complete Documentation

Formatting

• [Headings](docs/formatting/headings.md)
• [Lists](docs/formatting/lists.md)
• [Text Styles](docs/formatting/text-styles.md)
• [Quotes](docs/formatting/quotes.md)
• [Links](docs/formatting/links.md)
• [Code Blocks](docs/formatting/code-blocks.md)
• [Tables](docs/formatting/tables.md)
• [Formulas](docs/formatting/formulas.md)
• [Emojis](docs/formatting/emojis.md)
• [Footers & Slide Numbers](docs/formatting/footers-and-slide-numbers.md)
• [Footnotes](docs/formatting/footnotes.md)
• [Line Breaks](docs/formatting/controlling-line-breaks.md)
• [Columns](docs/formatting/columns.md)

Media

• [Background Images](docs/media/background-images.md)
• [Inline Images](docs/media/inline-images.md)
• [Videos](docs/media/videos.md)
• [Audio](docs/media/audio.md)
• [Mermaid Diagrams](docs/media/markdown-graphs.md)

Presenting

• [Presenter Notes](docs/presenting/presenter-notes.md)
• [Build Steps](docs/presenting/build-steps.md)
• [Transitions](docs/presenting/transitions.md)
• [Hide Slides](docs/presenting/hide-slides.md)
• [Presenter Display](docs/presenting/switch-presenter-display.md)

Customization

• [Configuration](docs/customization/configuration-commands.md)
• [Custom Themes](docs/customization/custom-theming.md)

Reference

• [Getting Started](docs/general/getting-started.md)
• [Keyboard Shortcuts](docs/general/keyboard-shortcuts.md)
• [FAQ](docs/general/frequently-asked-questions.md)

Examples

See complete working presentations in examples/:

• simple-presentation.md - Basic structure
• technical-presentation.md - Code & diagrams
• visual-presentation.md - Image-focused

Common Mistakes

1. Missing blank lines around --- → Slides merge
2. Wrong heading levels → Use ## for most slides
3. Incorrect image syntax → ![fit](image.png) not ![fit image.png]
4. Config after first slide → Must be at very top

Best Practices

1. One idea per slide
2. Use high-quality images
3. Leverage presenter notes for details
4. Test builds before presenting
5. Version control with git

Troubleshooting

Slides merging? Check blank lines around ---

Images not showing? Verify file paths, use forward slashes

Text too small? Use [fit] modifier or autoscale: true

Official docs: https://docs.deckset.com/English.lproj/