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.gitThen crosspresent demo to see everything, or crosspresent new mydeck to start. Python 3.8+, macOS, Linux and Windows. MIT licensed.
--- 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]}]} ```
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.
A ## heading starts a slide. A # heading makes a title slide.
## Q3 results Revenue grew in every region.
Bar, hbar, line, area, pie and donut, from inline numbers or a CSV file.
```chart
{ "type": "line", "data": "runs.csv" }
```Big numbers with a label and a colour.
```stats 94% | pass rate | green 4 | flaky | amber ```
Text beside a chart, or up to four columns, with an optional ratio.
```columns 2:1 - What changed ||| ```chart …``` ```
Grids of cards, highlighted callouts, badges like [[shipped|good]].
```note Heads up Rollout starts Monday. ```
Kept in the source, shown only when you build with --notes.
```notes Pause here for questions. ```
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.
Switch with one line of frontmatter. Each preview below is the same demo deck, live.
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.
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
Teaches Claude when to use crossPresent and how to write a good deck.
crosspresent skill install
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
Fonts, charts and images go inside the HTML. It opens anywhere, offline, years from now.
crosspresent pdf talk.md -t deck prints true 16:9 pages with the Chrome, Edge or Brave you already have.
crosspresent serve talk.md rebuilds and reloads the browser every time you save.
Notes stay in the source and only appear when you build with --notes, so one file gives a rehearsal copy and a clean one.
Pick a palette, set an accent, or embed your own font with font_file. Dark and light mode come free.
A single Python file using only the standard library, with 130+ tests. Nothing to audit but the one file.
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.
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.
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.
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.
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.
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.
$pipx install git+https://github.com/OpenStruct/crosspresent.git