deckset-presentation-expert

name	deckset-presentation-expert
description	Expert assistant for creating Deckset presentations with markdown. Helps with slide formatting, headings, lists, images, videos, presenter notes, build steps, themes, and configuration. Use when working with .md presentation files, or when user mentions Deckset, creating slides, presentations, or decks.

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/