| 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
- Slide Separators:
--- MUST have blank lines before and after
- Headings:
# = title slide, ## = slide title, ### = subtitle
- Images:
 = background,  = inline
- Presenter Notes: Start line with
^ (hidden from slides)
- 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
 # Full-screen background
 # Inline with text
 # Fill space
 # Custom size
 # 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
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
Media
Presenting
Customization
Reference
Examples
See complete working presentations in examples/:
simple-presentation.md - Basic structuretechnical-presentation.md - Code & diagramsvisual-presentation.md - Image-focused
Common Mistakes
- Missing blank lines around
--- → Slides merge
- Wrong heading levels → Use
## for most slides
- Incorrect image syntax →
 not ![fit image.png]
- Config after first slide → Must be at very top
Best Practices
- One idea per slide
- Use high-quality images
- Leverage presenter notes for details
- Test builds before presenting
- 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/
