deckset-presentation-expert（甲板演示专家）

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

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

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/