Presentations

A presentation is one Markdown file: each heading starts a slide. Everything in the basics works here too. Each example below is real: in Jollify, Insert puts it in your deck at the cursor, and the preview beside it is drawn in your deck's theme.

Slides and sections

Each heading starts a new slide. With both # and ## headings, a # heading is a section and the ## slides under it show its name small above their own title.

# Results

## Ahead on visitors

## Behind on volunteers

Try it in Jollify

You get two slides, each with "Results" as a small label over its title.

A slide without a heading

Three dashes on a line of their own start a new slide where you don't want a heading.

## Our team

Five of us, all volunteers.

---

A quiet slide with only this sentence on it.

Try it in Jollify

You get two slides; the second has no heading.

The cover

Put {.cover} after the first heading to draw that slide as the title page.

# Summer fair 2026 {.cover}

## A day out for the whole village

Try it in Jollify

You get a cover slide, with the second line as its subtitle.

Columns

Put things side by side with a columns block holding one column block for each.

## Before and after

:::: columns
::: column
Paper forms, posted twice a year.
:::
::: column
One online form, open all year.
:::
::::

Try it in Jollify

You get two columns side by side on the slide.

Big numbers

To make a few numbers the point of a slide, put a list in a numbers block and start each item with the number in bold. Two to four read best.

## The year in three numbers

::: numbers
- **£1.2m** Raised this year
- **312** Customers, 41 of them new
- **97%** Would recommend us
:::

Try it in Jollify

You get the numbers side by side across the slide, each large in the theme's accent colour, with its caption small underneath.

Feature cards

To put a block inside another, such as a shape inside a column, give each outer block more colons than the one inside it. Insert ▸ Feature cards writes this for you.

## Three things it does

:::::: columns
:::: column
::: shape circle {fill=#6366f1 size=30%}
1
:::
### Works offline
Everything you need on the train.
::::
:::: column
::: shape circle {fill=#10b981 size=30%}
2
:::
### Scans receipts
Point the camera and the claim fills itself in.
::::
::::::

Try it in Jollify

You get two cards side by side, each with a numbered circle over its heading and sentence.

Tables at slide size

A table that is alone on its slide (only a heading with it) fills the slide's width in large type. To make any table large, put {.large} on the line just before it. To colour a status column, put {.rag} there instead: each cell that starts with Red, Amber or Green gets that colour.

## Where we are

{.rag}
| Project | Owner | Status |
|---|---|---|
| Website | Sam | Green |
| Hiring | Priya | Amber: two roles open |
| Launch | Jo | Red |

Try it in Jollify

You get the table across the slide, with a coloured dot and coloured words in each status cell.

A pull quote

A quote that is alone on its slide shows large, with a big opening mark. Put who said it in its own last paragraph, and it shows small underneath.

## What a customer said

> It took us an afternoon to move the whole team over.
>
> — Dana Reyes, Head of Operations

Try it in Jollify

You get the quote across the slide in large type, with the name small under it.

Fragments and builds

Points that appear one at a time, a press at a time: put the list in a fragments block. in= says how each one arrives.

## Three steps

::: fragments
- We listen {in=fadeInUp}
- We plan {in=fadeInUp}
- We build {in=fadeInUp}
:::

Try it in Jollify

You get the heading first; each press brings in the next point, rising into place.

A word or picture that arrives

in= works on any line: a heading, a paragraph or a picture arrives on a press of its own.

## The answer is {in=fadeInDown}

Forty-two. {in=zoomIn}

Try it in Jollify

You get a slide that starts empty; the heading drops in, then the answer zooms in.

Click to play

A click on one thing can show, hide or play another, as PowerPoint's triggers do. Give the thing to click a name with {#…}, and put when= with that name on what it starts. Those wait for the click, not a press, and each click plays them again.

## Click the logo

![Our logo](https://jollify.app/images/logo-100.png){#logo}

Founded in 1998 by two engineers. {in=fadeInUp when=#logo}

Click the logo to find out. {out=fadeOut when=#logo}

Try it in Jollify

You get the logo and the line under it; a click on the logo brings in the story and takes the hint away. A sound can wait for the click too: ![](chime.mp3){when=#logo} has no player on the slide, and the click plays it. In the Designer, select the logo and use the Animate tab's When clicked (Play a sound…, Show, Hide, Animate): it writes the names for you. Choose what it acts on from the list, or with Pick on the slide… and a click on it in the preview. Try it plays what the click does, there in the preview. Animate plays an animation you recorded on the slide; on the animated thing, the Animate tab's Plays menu also offers "on a click of #logo".

3D models

Put a .glb or .gltf file on a slide with Insert › Media…, or write it as you would a picture:

![A wooden box with a hinged lid](models/box.glb)

Try it in Jollify

When you present, people can drag to turn it and pinch or Ctrl+wheel to zoom, and that doesn't move the slide on. In the Designer a click selects it instead, so you can size and place it with the Style tab. The words in the square brackets are read by screen readers and shown when a browser can't draw 3D, so describe the model.

A .glb keeps everything in one file. A .gltf often reads other files beside it, such as a .bin or its textures: put those in your files too, in the same folder, and the deck keeps them inside the model, in the preview and in what you export. Compressed models (Draco or meshopt) work too, and an exported deck carries what it needs to open them.

Printing and PDFs show a still picture of it. Choose your own with {poster=box.png}. Other options: {auto-rotate=20} turns it slowly until someone touches it, and {background=#f4f1ea} gives it a colour behind it. A model can also be the slide's background: see A model behind the slide below.

A model file can carry its own animations, such as a lid that opens. Click the model, then open the Animate tab: The model's animations lists the ones in the file. Try it plays one, and the list beside it says when it plays in the presentation: On a press or When it's clicked.

In Markdown, steps plays them one for each press of Next, and going back undoes the last one before it goes back a slide. play with when plays them on a click, the next one each time. The names are the ones in the file, spelled the same way:

![A wooden box with a hinged lid](models/box.glb){steps="Open, Close"}
![A wooden box with a hinged lid](models/box.glb){#box play="Open, Close" when=#box}

A model behind the slide

![bg] with a .glb or .gltf file puts the model behind the whole slide, turning slowly behind the words. In Insert › Media…, choose the model and tick Use as the slide's background.

## Made to last

![bg](models/box.glb)

Every box is cut from one oak board.

Try it in Jollify

You get the model filling the slide behind the heading and the words, turning by itself. A click on a word still reaches the word, and a swipe still changes slide. Words you can add after bg, as for a picture:

  • still: the model doesn't turn by itself (Turning off in Insert › Media).
  • interactive: people can drag to turn it when you present (People can turn it).
  • dim: darkened, so light words on it read.
  • hold: it stays for the next slides, and keeps the way it was turned.
  • left / right: it fills only that half of the slide.

Printing and PDFs show a still picture of it behind the words.

Charts

A chart is a table in a chart block. The first column is along the bottom; each other column is a set of bars, named by its heading. Insert › Chart… writes this for you, from a chart in your files or from rows you type or paste.

## Visitors

::: chart bar {title="Garden visitors" y-label="Thousands"}
| Year | Online | In person |
|------|-------:|----------:|
| 2024 | 12     | 30        |
| 2025 | 18     | 26        |
:::

Try it in Jollify

You get a bar chart in your theme's colours, with a key for Online and In person. The other kinds are stacked, line, area, waterfall, pie, donut and scatter. A scatter needs a number in the first column, because it places each dot to scale; add joined for a line through the dots.

Diagrams

A diagram is a process, an org chart, a timeline or a flowchart. Insert › Diagram… opens an editor where you add the boxes; it keeps the diagram in your files and writes the block for you. To change it later, pick it and choose Edit diagram….

## How joining works

::: diagram {title="Joining"}
{ "type": "process", "nodes": [ { "id": "a", "text": "Fill in the form" }, { "id": "b", "text": "Meet the team" }, { "id": "c", "text": "First shift" } ] }
:::

Try it in Jollify

You get three steps joined by arrows, drawn in your theme's colours.

Shapes and icons

A shape block puts your words on a shape: a circle, an arrow, a star, a speech bubble or an icon. Insert › Shape… lets you pick one.

## Our promise

::: shape circle {fill=#f6c3cb size=46mm}
Free to all, every weekend.
:::

Try it in Jollify

You get a pink circle with the words in the middle.

Shapes that come with Jollify

About 40 shapes come with Jollify: everyday shapes, arrows, speech bubbles, banners, stars and flowchart boxes. They're in Insert › Shape…, on the Built in tab: click one and it goes in as a picture, and a copy is kept with your own shapes. They're also on the Dashboard's Assets tab, under Shapes. A built-in shape can't be changed itself: to change one, pick ⋯ › Duplicate on its card, then click your copy to draw on it.

The fonts that come with Jollify are on the Assets tab too, under Fonts, each one shown in itself. They're free to use, including in work you sell, and the link on each card has its licence.

Draw your own

To draw a shape of your own, as you would in Paint, use Draw a shape… in Insert › Shape…, or on the Dashboard's Assets tab, New › Draw a shape… under Shapes. Press and drag to make a mark. Each mark stays separate, so you can pick it later and move it, turn it or change its colour. Hover over a tool to see what it does and its key. Shapes you've saved are at the top of Insert › Shape…, under Your shapes: click one to use it again.

Ready-made shapes has a heart, a speech bubble, a cloud, arrows and more: choose one, then press and drag. Words turns what you type into a shape, so it looks the same everywhere: you can colour it, but not retype it. To make one shape out of several, pick them and press Join. Cut out takes the shapes on top out of the one underneath, so a circle on a square leaves a hole you can see through. The Eraser removes whole marks, or set Rub out to Part of a line and it takes only what you drag across.

Save asks for a name and keeps the shape in your Assets. It goes on a slide as a picture, so it looks the same in Present, a PDF and an exported file. To change it later, click its card on the Assets tab: saving changes it everywhere it's used, or Save a copy keeps the one you had. You can open a shape you uploaded the same way. Anything in its file that could run code or fetch from the internet is left out, and the editor tells you what went. Download a picture gives you a PNG with a see-through background, to use somewhere else.

Pictures and backgrounds

![bg] puts a picture (or a colour) behind the whole slide; ![bg left] fills the left half.

## Spring

![bg](#2e7d32)

The garden opens on the first of April.

Try it in Jollify

You get a slide with a green background behind the words.

If the words are hard to read over a photo, as on a cover, write ![bg dim](photo.jpg): the picture is darkened and the words turn white. On a split, ![bg left dim] darkens only the picture's half.

Picture galleries

To fill a slide with photos, put the pictures in a gallery block: they are packed edge to edge in rows, each cropped to fill its share.

## Made with Jollify

::: gallery
![A presentation](https://jollify.app/images/demo-deck.png)
![A website](https://jollify.app/images/demo-site.png)
![The editor](https://jollify.app/images/editor.png)
:::

Try it in Jollify

You get a mosaic of the three pictures across the slide, with no gaps between them.

YouTube and Vimeo

Paste a YouTube or Vimeo link as a picture and you get the video's player. Insert › Media… (a picture, a sound or a video) takes the link and asks for a title.

## Our film

![video: The harbour walk](https://youtu.be/dQw4w9WgXcQ)

Try it in Jollify

You get the video on the slide, ready to play when you present. With no internet it shows the video's picture with a play button instead.

A video behind the slide

![bg] with a video link plays it silently behind the slide, over and over.

## Welcome

![bg](https://vimeo.com/1084537)

Try it in Jollify

You get the video filling the slide, muted and looping, behind the heading.

Documents on a slide

A PDF, a Word document, a spreadsheet or a PowerPoint can sit on a slide, or open over the presentation when you click it. Insert › Document… picks the file and writes the line for you. It looks like a picture, with the document's file in place of the picture's:

  • ![Q3 sales report](q3-sales.pdf) shows the PDF's first page on the slide. Add {page=4} to start on page 4, or {pages="4-6"} to turn one page with each Next. The whole page shows; {fit=width} fills the slide's width and scrolls instead, for a page too small to read whole.
  • ![Terms](terms.docx) does the same for a Word document, with the same choices.
  • ![Sales by region](sales.xlsx) shows the first sheet as a table. {sheet="By region" range=A1:F20} picks one sheet and its cells; {sheets} shows every sheet, with its tabs.
  • A PowerPoint plays inside the slide. Insert › Document… brings it in as a presentation of its own, kept beside this one, and writes ![Last quarter's review](import/q2-review/deck.md). {slides="3-5"} keeps only those slides, one with each Next.
  • {open} on a PDF, a Word document or a PowerPoint shows a card instead: a click opens the document over the presentation, and Esc brings you back to the same slide. A spreadsheet always sits on the slide.
  • A link, see [the full report](q3-sales.pdf), opens it over the presentation too.

The words in the square brackets are the document's title, and what a screen reader says.

One background for several slides

Add {.background} to a heading to make that slide a background: its picture (or colour) stays behind every slide after it, until the next background. Its heading is only a name and isn't shown, and you never step to it when you present.

## Night sky {.background}

![bg](#1e3a8a)

## Arrivals

The first coach gets in at six.

## Departures

The last one leaves at ten.

Try it in Jollify

You get both slides drawn over the same dark blue, and no slide of its own for the background.

Quizzes

A question with choices: the first line is the question, [x] marks the right answer, and a line starting with > explains it.

## Planets

::: quiz
Which planet is the largest?
- [ ] Mars
- [x] Jupiter
- [ ] Venus
> Jupiter is bigger than all the other planets put together.
:::

Try it in Jollify

You get the question with three choices; when you show the answer, Jupiter is marked right and the explanation appears.

Quizzes with a class

Students following the presentation on their own phones or tablets can answer a quiz themselves. They choose, add their name if they like, and press Send my answer, up until you show the answer. Then their own screen says whether they got it right. In the Presenter view, under the quiz, you see how many have answered and how many are right; the room's screen shows none of it. Results… there downloads every answer as a spreadsheet, and Try again clears that quiz's answers.

When you're signed in, Present's menu has To a class…: it shows a class code on the screen, and students open the address with that code from anywhere. Class results… lists the classes you've presented, with their answers as a spreadsheet. Answers are kept in your account for a year.

Export, then Share to Google Classroom… posts the presentation to a class in Google Classroom. You sign in with your school account and choose the class there. Students who open it can go through it and answer its quizzes.

Particles

Snow, rain, petals, feathers, confetti or bubbles falling over a slide.

## Winter

::: particles snow
:::

Try it in Jollify

You get snow falling gently over the slide while it is shown. On a light slide, the pale kinds (snow, rain, feathers, bubbles) turn darker so you can still see them.

To choose the colour yourself or add a soft glow, use the Particles… dialog, or write them in: ::: particles snow {colour=#3366cc glow=1}.

Make a video

Choose Export, then Video (.mp4)… (Video (.webm)… in a browser that can't record MP4). Your deck plays from start to finish in the tab and your browser records it. When it asks what to share, choose this tab, and leave its sound on if your deck has any. The video is the size of the window, so make the window large first, and stay on the tab until it's done. Tick Show speaker notes as subtitles to have them in the picture. Stop sharing at any time to cancel.

To give slides their own time, choose Rehearse timings from the arrow beside Present, run through your talk, and close the window at the end. The app writes each slide's time on its heading, or you can type it:

## Our results {data-duration=20}

Try it in Jollify

The slide stays up for 20 seconds, shared between it and its builds. It changes how long a video shows the slide, and nothing when you present.

Speaker notes

Notes are for you, not the audience: they show in the presenter view, and nowhere else. The easiest way is to type them in the Notes box under the slide in the Designer: the app writes them into the slide as a ::: notes block, like this one.

## Our results

::: notes
Thank everyone for coming. Mention the new volunteers.
:::

Try it in Jollify

You get a slide with the heading only; the notes wait in the presenter view. A short note can also go in a comment:

## Thank you

<!-- notes: Remind everyone about the raffle. -->

You get a slide with "Thank you"; the note waits in the presenter view.

Slide transitions

data-transition on a heading says how that slide comes in. Settings… in the logo menu sets one for every slide.

## Next year {data-transition="fade"}

Try it in Jollify

You get a slide that fades in instead of sliding. transition at the top of the deck does the same for every slide:

---
title: Parents' evening
transition: fade
---

# Parents' evening {.cover}

## Welcome

You get a deck whose slides fade into one another.

Hide a slide

Add {.hidden} to a slide's heading to skip it when you present, without deleting it.

## Spare slide {.hidden}

Only if there is time.

Try it in Jollify

You get a slide that stays in your document but is stepped over in the show.

Themes

The theme at the top of the deck picks its look: plain, dusk, report, dark or cinema, or one of your own. Settings… in the logo menu changes it.

---
title: Summer fair
theme: dusk
---

# Summer fair {.cover}

Try it in Jollify

You get the whole deck drawn in the dusk theme. accent changes the theme's accent colour:

---
title: Summer fair
theme: dusk
accent: "#e07a5f"
---

# Summer fair {.cover}

You get the dusk theme with an orange accent.

Slide size

The aspect at the top of the deck sets the shape of every slide: 16:9 (wide, the default), 4:3 (squarer, for older projectors) or 16:10. Settings… in the logo menu changes it.

---
title: Staff meeting
aspect: 4:3
---

# Staff meeting {.cover}

Try it in Jollify

You get slides four wide to three high.

Page numbers and progress

paginate at the top of the deck shows how far through you are: true puts a progress bar along the top and the slide number in the corner, bottom puts the bar along the bottom instead, and circle shows a ring in the corner with the slide number in it (circle logo puts the deck's logo in the ring instead). The cover has no number. Settings… in the logo menu changes it.

---
title: Staff meeting
paginate: bottom
---

# Staff meeting {.cover}

## Agenda

Try it in Jollify

You get a progress bar along the bottom of every slide, and the slide's number in the corner after the cover.

Title, description and author

The first time you Save as, Jollify asks for the deck's details. On This item: its title, a description (the Jollify Player shows it under the title), the author, a version and a language, and its thumbnail, which is the largest picture on the first slide unless you pick another picture from the deck or one from disk. On Package: the same for the .jollify file as a whole. Details… in the logo menu changes them later. The title, description and author can also sit at the top of the deck, and the dialog offers to write them there for you:

---
title: Summer fair
description: A day out for the whole village
author: Parish council
---

# Summer fair {.cover}

Try it in Jollify

You get the description and author in the page's own details, and filled in when the dialog asks.

Put several decks in one package

A package is one .jollify file holding several decks, grouped if you like, as the Jollify Player shows them. On Documents, open a deck's ⋯ menu and choose Add to package…: pick a package (or A new package, and give it a title), the group to put it in (or A new group…), and the deck's title and description in the package. The package keeps its own copy of the deck, so changing the deck afterwards doesn't change the package until you choose Update in "…" on the deck's ⋯ menu; Remove from "…" takes the copy out. Neither touches the deck itself. When you change a deck after copying it, its card says, for example, In Pitches · out of date, and its Update in "…" is in bold; the package editor shows The original has changed on that item, with an Update button. If the package's copy has been edited too, Update asks before replacing it. You can also start an empty one: New (+), then Package, and give it a title. A package can hold reports, websites and venue layouts as well as decks: their ⋯ menus have Add to package… too, and everything below works for them the same way.

A package has a card of its own on Documents, with its title and how many items it holds. Its picture moves through its items' thumbnails (it stops while your pointer is on it). If none of them has a picture, it shows its first deck's first slide instead. Its ⋯ menu has Rename…, Duplicate (a second package with its own copies), Download, which makes the .jollify file, and Delete…, which deletes the package and the copies in it, never the decks they were copied from.

Click a package's card to open it. On the left is what it holds, in the order the Player shows it; click the package, a group or a deck to see and change its title, description and other details on the right. They're kept as you type. New group makes a group (inside the one you've picked); drag a deck or a group onto a group to put it inside, onto a deck to put it just before that deck, or onto the package at the top to bring it out of every group (Up, Down and In do the same from the keyboard); Ungroup takes a group away and keeps what was in it; Remove takes a deck out of the package (or an empty group). Edit opens the package's copy of a deck in the deck editor, with ‹ and the package's name at the top to go back: what you change there is in the package, and the deck it was copied from stays as it was. Play presents the package's copy of a deck in a new window; for a report it shows the laid-out pages, for a website the site, and for a venue the scene to walk round, each as the package will hold it. A deck's Thumbnail is its cover picture (the largest on its first slide) unless you pick another picture it uses, or one from your computer with A picture from disk…; the package and each group can have a Thumbnail too, picked from any of its decks' pictures or, with A picture from disk…, from your computer (it goes into your files, and into the .jollify when you download); the Jollify Player shows a group's description under its heading and its thumbnail among the pictures beside the list. Download at the top makes the .jollify file; it reuses each deck it made last time unless that deck, its details or a picture it uses has changed since, so a second Download is quicker. Decks that use the same version of Jetty and the same theme share one copy of each in the file, so five decks don't carry Jetty five times.

In the Jollify app, a package in your library has Edit on its card on Home, and on each deck, report, website or venue when you open it there. Edit on the card opens the whole package; Edit on one of its items opens that item in its own editor. Save in the package editor, Ctrl+S in an item, and going back to Home all keep your changes in the package in your library. Present on one of its decks plays it in the app, and Esc brings you back to the editor.

On an Android phone or tablet, the Jollify app asks before anything you export or download is kept (a package, a web page, the plain text): Save to a file… saves it on the device, and Share… sends it to another app, such as email, Drive or a message. A PDF goes through the print screen instead, which has its own Save as PDF.

Once you've clicked a row, the list has keys of its own: ↑ and ↓ pick the row above or below, Home the package and End the last row; Alt with ↑ or ↓ moves the picked row up or down in its group; Enter edits a deck, and Delete removes it (after asking) or an empty group. ? at the top lists them, and has a short Tour of this page.

Opening a .jollify file that holds several decks (New, then Open file…; or dropping it on Documents) makes a package of it and opens it here, with its groups and details. Its pictures go into Files, in a folder named after the package (Pitches, or Pitches 2 if that's taken), so two packages never overwrite each other's pictures. A deck that was saved only to play, without its Markdown, is kept as it is, in that folder: you can move it, change its details, Play it as it was saved and download it again with the package, but not edit it here. The package's and its groups' own pictures come along too, into the same folder, and so does a deck's thumbnail that isn't one of its slides' pictures. A file with one deck opens as that deck. In Files, a picture a package's deck uses says so: used by Pitches ▸ Q3 review (its thumbnail too, even one from disk that no slide shows), and one the package or a group shows as its thumbnail says used by Pitches.

Bring in a PowerPoint

On Documents choose New, then Import PowerPoint or Google Slides, and pick a .pptx file, or drop the file on Documents. From Google Slides, choose File → Download → Microsoft PowerPoint (.pptx) first; from Keynote, File → Export To → PowerPoint. Then choose how it looks:

  • Keep the look: the deck's own colours, fonts and layout, as close as a web page gets. Each slide's place for its words and pictures comes with it, and stays with the slide when you add, move or delete slides around it.
  • Use a Jollify theme: your words, pictures and notes, laid out by the theme you pick.

Either way you get a Markdown deck you can change like any other. The import report under it lists anything that didn't come across exactly; click a line to go to its slide, and Close when you've read it. Under a Jollify theme, a slide with more words than the theme's layout holds is listed as words run off the slide: shorten them, split the slide, or press Import again, keeping the look, which makes a second deck from the same file and leaves this one in Documents.