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/