How to write slides in Markdown

Start with two slides

# First slide

A short promise.

---

## Second slide
- One point
- Another point

Formatting that works

1. Use #, ##, or ### for headings.
2. Use -, *, or + for bullet lists and numbers for ordered lists.
3. Use fenced code blocks, block quotes, links, images, and simple Markdown tables.
4. Start a line with Note: or ??? to add speaker notes to that slide.

Choose a layout only when needed

Add <!-- layout: title -->, <!-- layout: center -->, or <!-- layout: two-col --> to a slide. A simple opening slide is detected as a title layout automatically.

Export options

HTML export creates a self-contained presentation with keyboard navigation. PDF uses the browser print dialog, and PPTX creates editable text boxes, lists, tables, and speaker notes. Remote images can fail in PPTX when their host blocks browser access.