crossPresent demo

crossPresent — Feature Tour

Every block type the generator supports, in one deck. Open the source file side by side with this page — each slide shows what the Markdown looks like rendered.

1
markdown file in
1
html file out
0
dependencies
6
chart types

The whole deck you are reading was generated from examples/demo.md with one command:

crosspresent build examples/demo.md
02

Text, badges and notes

The first paragraph of every slide is styled as an intro — slightly larger, capped at a readable line length. Use it to frame the slide.

Regular paragraphs follow. Inline markup: bold, italic, inline code, and links. Badges are double-bracket shorthand:

  • [[shipped|good]] renders shipped
  • [[in review|warn]] renders in review
  • [[broken|bad]] renders broken
  • [[v2.1|info]] API design infra plain
Notes are blockquotes

Start the first line with a bold phrase and it becomes the note's label. Use these for the "here is the catch" moments — the thing you would say out loud while presenting the slide.

03

Bar and grouped bar

A chart is a fenced block tagged chart containing JSON. Single values array gives you one series; series gives you groups and an automatic legend.

Tests by category
01020309Positive12Negative21Combos3Schema2Multihit3HTTP6Non-func4Offline
Pass / fail by run
020406080MonTueWedThuFri
passedfailed
04

Horizontal bars

hbar suits long labels — categories read left to right instead of being crushed under the axis. Add "colorful": true to cycle the palette per bar.

Where the suite spends its time
Live API round-trips8.2Schema validation2.1XML parsing1.4Fixture setup0.9Report generation0.4
05

Lines and areas

line takes the same JSON as bar. Multi-series gets a legend; an area chart is a line with the region under it filled.

p95 latency by week (ms)
050010001500W1W2W3W4W5W6W7W8
resolve by DOIresolve by metadata
Suite size over time
020406080JanFebMarAprMayJun
06

Pie and donut

pie and donut take one series. The legend carries values and percentages, so the slices stay clean.

Test outcomes
67
passed — 94%xfail (documented findings) — 4.5%skipped — 1.5%
07

Charts from data files

Instead of inline numbers, point a chart at a CSV (or JSON) file with "data". First row is the header, first column is the labels, every other column becomes a series. The chart below comes straight from data/weekly.csv — regenerate the CSV in CI and the deck stays current.

Outcomes by week — from data/weekly.csv
020406080W1W2W3W4
passedfailed
08

Stat tiles

A stats block is one line per tile: value | label | color. Colors: green, amber, red, blue, gray (or leave blank).

63
passed
3
xfail
1
skipped
≈ 13 s
wall-clock
09

Tables

Standard pipe tables, with alignment markers in the separator row. Cells take the full inline syntax — badges included.

IDWhat it doesStatusRuntime
TP-01Default id=doi:… resolvespassing0.4 s
TN-03title alone should be rejectedxfail — Finding 20.3 s
S-03Unresolved envelope validatesskipped — Finding 7—
10

Cards

A cards block splits on ### headings into a responsive grid. Column count is automatic (2 or 3) or forced with `cards 3 .

Black-box only

Assert on what the API outputs — status, headers, body, timing. Nothing about server internals.

Offline / live split

Live tests skip unless --run-live is passed, so CI without network access still has a gate that means something.

One HTTP client

Every test goes through one client — base URL, retries, pacing. Tests read as intent, not plumbing.

11

Columns

Put things side by side with a columns block. Separate columns with a line containing only |||; add a ratio like 3:2 to set their widths.

Why it matters

  • Text and a chart on one slide, without HTML
  • Each column is ordinary slide Markdown
  • Collapses to one column on narrow screens
Time to first deck
100
Writing — 80%Styling — 15%Exporting — 5%
12

Code and pills

Fenced code with any other tag renders as a code block:

def resolve(doi: str) -> Response:
    return client.get(params={"id": f"doi:{doi}", "redirect": "false"})

A pills block makes a row of link chips — good for closing slides:

13

That's every block.

Scaffold your own deck and start from a working file:

crosspresent new mydeck
crosspresent build mydeck.md --open --controls   # arrow keys + F for fullscreen
crosspresent pdf mydeck.md                       # 16:9 PDF with -t deck