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

Lists

- Bullet point
  - Sub-point (2 spaces)

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

See docs/formatting/lists.md

Text Formatting

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

See 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 and docs/media/background-images.md

Code Blocks

```python
def hello():
    print("Hello")
```

See 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

Videos

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

See 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

Advanced Features

Columns

[.column]
Left content

[.column]
Right content

See docs/formatting/columns.md

Formulas (LaTeX)

$E = mc^2$

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

See docs/formatting/formulas.md

Mermaid Diagrams

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

See docs/media/markdown-graphs.md

Build Steps

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

See docs/presenting/build-steps.md

Complete Documentation

Formatting

• •Headings
• •Lists
• •Text Styles
• •Quotes
• •Links
• •Code Blocks
• •Tables
• •Formulas
• •Emojis
• •Footers & Slide Numbers
• •Footnotes
• •Line Breaks
• •Columns

Media

• •Background Images
• •Inline Images
• •Videos
• •Audio
• •Mermaid Diagrams

Presenting

• •Presenter Notes
• •Build Steps
• •Transitions
• •Hide Slides
• •Presenter Display

Customization

• •Configuration
• •Custom Themes

Reference

• •Getting Started
• •Keyboard Shortcuts
• •FAQ

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/