Markdown To

SpecificationsnormativeSheet 14 of 18

slides@0.1

Make the room see your point.

A presentation with a point of view: generous type, deliberate layouts, speaker notes, and one faithful page per slide.

File
*.slides.md
Unit
slide
View
presentation + PDF
Codes
MDTO1400–1499
Read agent skill · authoring and editorial guide

01

Make the room see your point.

A presentation with a point of view: generous type, deliberate layouts, speaker notes, and one faithful page per slide.

A real conforming file, rendered by the same engine as the CLI.
Read the example Markdown
---
markdownto: [email protected]
title: Make room for the idea
aspect: '16:9'
theme: paper
font: editorial
font-size: 28
---

## A picture can open the conversation

[layout:: image-right]

![Morning mist over an alpine lake and a timber jetty](slides-lake.png)

Start with something people can see.

Give them one thought to carry into the room.

### Notes

This is an AI-generated illustrative landscape, not a photograph of a named place. Use arrow keys to move through the deck. Each slide demonstrates an available layout.

## One idea. A little breathing room.

[layout:: title] [background:: #20352b] [color:: #f7f3e8] [accent:: #edb58b]

A small field guide to a richer presentation.

### Notes

Pause here. The title layout gives a short thought room to land.

## Three things worth keeping

[layout:: standard]

- **A clear claim.** Say what this slide is here to do.
- **Useful evidence.** Show the picture, example, or comparison.
- **An honest ending.** Tell people what follows from it.

### Notes

Bullets work best when they are short enough to hear and read at the same time.

## Let the picture do some work

[layout:: image]

![A quiet lake reflecting mountains in morning light](slides-lake.png)

Space, light, and a clear point of attention. Illustrative AI-generated image.

## A line worth remembering

[layout:: quote] [background:: #eee5d3] [color:: #443324] [accent:: #984329]

> Give the idea room to land.

An editorial principle for this example deck.

## From a list to a story

[layout:: split]

### A list of things

Features. Updates. More features.

Everything asks for the same attention.

---

### A thread to follow

A question. An example. A consequence.

Each slide earns the next one.

## Find a rhythm

[layout:: three-column] [font:: sans] [font-size:: 24]

### Notice

Begin with a picture or a question.

---

### Understand

Add evidence and a useful comparison.

---

### Decide

End with one practical next step.

## The next chapter

[layout:: section] [background:: #20352b] [color:: #f7f3e8] [accent:: #edb58b]

A change of pace can make the next idea easier to hear.

## Two ways to explain an idea

[layout:: image-left]

![A geometric landscape in forest green and warm sand](slides-landscape.png)

A photograph shows texture.

An illustration reveals structure.

Choose the image that explains your point.

## Make space for motion

[layout:: video] [youtube:: https://www.youtube.com/watch?v=M7lc1UVf-VE]

![Preview of the YouTube IFrame Player API demonstration](slides-video.jpg)

An official YouTube player demo. Load it when ready; the link also works outside the deck.

### Notes

Playback needs the internet and a hosted page. Local files and PDF keep the YouTube link. Navigating away stops the embedded player. This demonstration video comes from YouTube's official IFrame API examples.

## Your next slide starts here

[layout:: title] [font:: sans] [font-size:: 32]

Keep one claim. Choose a layout. Check the fit.

Then make it yours.

Try the full slides workflow →

02

One clear meaning for every section

A level-2 heading is a slide. The canonical specification defines the precise structure, validation rules, and source-preservation guarantees. The companion skill teaches agents how to create useful content within that contract.

Read slides@0.1 · Read the authoring skill

03

A file, a renderer, and precise operations

Validate after authoring. Open the file as an application. Use the spec-owned verbs for deterministic operations and inspect their machine-readable results.

mdto validate example.slides.md
mdto render example.slides.md
mdto slides --help

Every saved answer or weight stays in the Markdown. Publication exports preserve the authored content. No renderer invents missing facts.

04

Refuse ambiguity. Explain the repair.

---
markdownto: slides@0.1
---

## Hello

[layout:: spinning]
  1. MDTO1402 error line 5

    ## Hello

    Layout must be one of: title, standard, split, quote, image, section, three-column, image-left, image-right, video.