Write the Markdown. Get the deck.

crossPresent turns one Markdown file into one self-contained HTML presentation, with real charts, stat tiles, columns and speaker notes. No dependencies, no JavaScript in the output, and a 16:9 PDF when you need one.

$pipx install git+https://github.com/OpenStruct/crosspresent.git
Open the live demo

Then crosspresent demo to see everything, or crosspresent new mydeck to start. Python 3.8+, macOS, Linux and Windows. MIT licensed.

weekly.mdwhat you write
---
title: Weekly test runs
template: deck
---
## Weekly test runs {#hero}

Pass rate held above 93% all quarter.

```stats
94% | pass rate | green
1,284 | tests | blue
4 | flaky | amber
```

```chart
{"type": "bar", "height": 210,
 "labels": ["W1", "W2", "W3", "W4", "W5", "W6"],
 "series": [
  {"name": "passed", "values": [58, 60, 61, 63, 62, 66]},
  {"name": "failed", "values": [6, 4, 5, 3, 4, 2]}]}
```
weekly.htmlwhat you get, live, built from the file on the left

Everything is plain Markdown

Headings make slides. Fenced blocks make everything else. If you can write a README, you can write a deck, and diff it, review it and keep it next to the code it describes.

Slides

A ## heading starts a slide. A # heading makes a title slide.

## Q3 results

Revenue grew in every region.

Charts

Bar, hbar, line, area, pie and donut, from inline numbers or a CSV file.

```chart
{ "type": "line", "data": "runs.csv" }
```

Stat tiles

Big numbers with a label and a colour.

```stats
94% | pass rate | green
4 | flaky | amber
```

Columns

Text beside a chart, or up to four columns, with an optional ratio.

```columns 2:1
- What changed
|||
```chart …```
```

Cards and notes

Grids of cards, highlighted callouts, badges like [[shipped|good]].

```note Heads up
Rollout starts Monday.
```

Speaker notes

Kept in the source, shown only when you build with --notes.

```notes
Pause here for questions.
```

Charts drawn at build time

Bar, horizontal bar, line, area, pie and donut charts become inline SVG when you build, so there's no charting library and nothing to load. Point a chart at a CSV and regenerate it in CI. The three below were drawn by crossPresent itself.

Build time, seconds
0204060v1.0v1.1v1.2v1.3v1.4v1.5
beforeafter
Where the time goes
100
Writing — 78%Charts — 15%Styling — 7%
Blocks per deck
chart9stats6columns4cards3notes2
defaultoceanforestmonocrimson

One file, three looks

Switch with one line of frontmatter. Each preview below is the same demo deck, live.

Hand it to your AI agent

Agents are good at writing Markdown. crossPresent turns that Markdown into a finished deck, so Claude, Cursor or Copilot can make you a presentation without hand-writing HTML.

MCP server

Built in, no extra install. Tools to read the guide, check a deck, build HTML and export a PDF.

claude mcp add crosspresent -- crosspresent mcp

Claude Code skill

Teaches Claude when to use crossPresent and how to write a good deck.

crosspresent skill install

Any agent with a shell

A guide written for agents, and a checker that returns errors as JSON so they can fix their own mistakes.

crosspresent guide
crosspresent check deck.md --json

Present it, print it, send it

One file you can email

Fonts, charts and images go inside the HTML. It opens anywhere, offline, years from now.

PDF in one command

crosspresent pdf talk.md -t deck prints true 16:9 pages with the Chrome, Edge or Brave you already have.

Live preview while you write

crosspresent serve talk.md rebuilds and reloads the browser every time you save.

Speaker notes, kept apart

Notes stay in the source and only appear when you build with --notes, so one file gives a rehearsal copy and a clean one.

Your brand, still offline

Pick a palette, set an accent, or embed your own font with font_file. Dark and light mode come free.

Small enough to read

A single Python file using only the standard library, with 130+ tests. Nothing to audit but the one file.

Questions

What is crossPresent?

A free, open-source command-line tool that turns one Markdown file into a self-contained HTML presentation. Headings become slides, and fenced blocks become charts, stat tiles, cards, columns, callouts and speaker notes.

Do I need Node, a framework or a build chain?

No. crossPresent is a single Python file that uses only the standard library. Install it with pipx (or run it straight from the repo with python3) on macOS, Linux or Windows.

How is it different from reveal.js, Marp or Slidev?

Those are great tools that run JavaScript in the browser to show your slides. crossPresent does the work at build time instead: charts are drawn as SVG from your data, and the output is one HTML file with no scripts, so it opens anywhere and keeps working offline.

Can I make charts from a CSV?

Yes. Point a chart block at a .csv or .json file next to the deck. The first column becomes the labels and every other column a series. Regenerate the file in CI and rebuild to keep the deck current.

How do I export a PDF?

Run crosspresent pdf talk.md. It uses Chrome, Edge, Chromium or Brave in headless mode. With the deck template you get 16:9 pages, one slide per page. You can also open the HTML and print.

Can I present with arrow keys and fullscreen?

Yes. Add controls: true to the frontmatter (or build with --controls) for arrow-key navigation, F for fullscreen and a progress bar. It's opt-in, so decks stay script-free unless you ask.

Your next deck is a Markdown file away

$pipx install git+https://github.com/OpenStruct/crosspresent.git
Star on GitHub