Codeck

Markdown decks with live Codex built in

Create teaching decks from plain Markdown, run Codex prompts directly on slides, and present the whole workflow from one native Mac app.

View on GitHub Read the format

.mdeck: Markdown files that macOS opens in Codeck.
Live cards: Run fenced Codex blocks from the slide itself.
Present: Switch from editing to full-screen teaching.

Codeck showing a Markdown editor, slide preview, and a live Codex card

Write, run, present, repeat.

Codeck keeps the lesson source, rendered slide, and live assistant output in one editing loop so prompting demos stay reproducible.

Author in Markdown

Plain slides, YAML deck settings, images, GIFs, and fenced code blocks.

Run Codex cards

Each prompt block has model, reasoning, sandbox, and a dedicated run button.

Preview the lesson

The slide updates beside the editor with syntax highlighting and rendered Markdown.

Teach full screen

Launch presentation mode and move through the deck with familiar arrow keys.

Prompting demos that actually run.

A fenced codex block becomes a live card on the slide. Deck defaults keep model, reasoning, and sandbox choices consistent, while individual sessions can override them when a lesson needs more precision.

Run one card or run every Codex session on the current slide.
Stream Markdown output into the rendered slide as the answer arrives.
Keep stable session IDs for repeatable lessons and demos.

```codex id=first-demo
title: First example
reasoning: xhigh
sandbox: read-only

Explain three practical ways to make
a prompt more testable.
```

First example ready

Explain three practical ways to make a prompt more testable.

Click run to simulate a streamed Markdown response.

---
format: codeck.mdeck
version: 1
theme: studio
codex:
  sandbox: read-only
  model: "gpt-5.5"
  reasoning: medium
---

# First Slide

Teach the workflow, then run it live.

A deck format you can read in a diff.

Codeck keeps decks as Markdown with YAML front matter. Slides are separated by a simple divider, and the document stays friendly to source control, review, and examples.

Markdown body YAML settings Theme metadata Codex defaults

Five moods for one lesson.

Switch the rendered deck between Studio, Midnight, Chalk, Solar, and Atelier without changing the source Markdown.

Studio

Prompt shape

Ask for observable behavior, name the verification path, then narrow the change.

```swift
let prompt = "Make this change testable"
```

Build lessons that can run in front of the room.

Codeck gives Markdown presentations a native editing loop and gives Codex prompts a stage where the result is part of the slide.

Open the project