Reports
A report is a set of chapters, one Markdown file each, laid out as printed pages. Everything in the basics works here too. Each example below is real: in Jollify, Insert puts it in the chapter you are writing, at the cursor, and the Pages move to it.
Chapters
Each # heading starts a chapter on a new page. ## and ### headings go in the contents under
it.
# Our year
## Highlights
The harbour walks ran every weekend from April.
You get a chapter starting on a new page, listed in the contents with "Highlights" under it.
A page that isn't counted
{.uncounted} on a chapter's heading puts it before the contents, with no page number: a welcome
or a foreword.
# Welcome {.uncounted}
Thank you for reading our plan.
You get a page before the contents, without a page number.
A kicker and a lead
A short line with {.kicker} above a heading is printed small and in capitals; a paragraph with
{.lead} is printed larger, to open a chapter.
Our promise {.kicker}
# Free for everyone
Every walk is free, and always will be. {.lead}
You get a small capital line over the heading, and a larger first paragraph.
A callout
A callout block is a box that stands out from the text round it, for a key fact or a warning.
# Safety
::: callout
Wear boots: the cliff path is muddy after rain.
:::
You get the sentence in a coloured box. A banner is a strip across the page, and a card a
rounded panel:
::: banner
Summer camp is back: 4 to 8 August
:::
::: card
**Volunteer of the year:** Sam, who ran the tuck shop every Saturday.
:::
You get a coloured banner and a card, each styled by the report's theme. ::: card dark gives a
dark card.
Pictures to the edge
Add {.bleed} to a picture to run it out to the edges of the paper.
{.bleed}
You get the picture across the full width of the page, with no white margin either side.
Text in columns
A columns block flows its text in columns across the page, as in a newsletter.
# News
:::: columns
The new benches went in at the start of May, paid for by the summer fair.
Volunteers painted them in the harbour's colours, and the school chose the names.
::::
You get the paragraphs set in two columns.
Numbered promises
A pledges block around a numbered list prints each item as a big numbered box; a bold start
is the box's heading.
# Our plan
::: pledges
1. **More walks.** Two a weekend from June.
2. **Better paths.** The cliff path resurfaced.
:::
You get two large numbered boxes, each with a bold heading.
Shapes
Insert › Shape… puts your words on a shape, in a shape block. On its Built in tab, about 40 that come with
Jollify go in with one click, as a picture.
A table of figures
A figures block around a table prints it as a table of figures: no grid, the numbers lined up on
the right, the units above them.
# Money
::: figures units="£"
| | 2025 | 2026 |
|---|---:|---:|
| Donations | 4,200 | 5,100 |
| Grants | 2,000 | 2,500 |
| **Total** | **6,200** | **7,600** |
:::
You get a clean table of figures with a total row under a double rule.
Charts
A chart is a table in a chart block, drawn when the report is built, so it prints sharply.
Type it as below, or Insert the example here and change the rows.
# Visitors
::: chart line {title="Walkers each month"}
| Month | Walkers |
|-------|--------:|
| April | 120 |
| May | 180 |
| June | 240 |
:::
You get a line chart in the report's colours.
Diagrams
A diagram is a process, an org chart, a timeline or a flowchart. Put its boxes in a diagram
block, or keep them in a file and name it with src=, as in ::: diagram {src=assets/diagrams/team.json}.
# 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" } ] }
:::
You get three steps joined by arrows, drawn in the report's colours and kept to a modest height on the page.
Footnotes
Put [^1] where the note is called and [^1]: with its text anywhere in the chapter, as long as it's outside any ::: block. The call can be inside one. Insert > Footnote does this for you, and gives each footnote its own number.
# Our year
Walkers rose by half.[^1]
[^1]: From the counts at the harbour gate.
You get a small number after "half", and the note at the foot of that page.
A new page
{.new-page} on a heading starts it on a new page, inside the same chapter.
# Costs
The summary comes first.
## The details {.new-page}
Line by line.
You get "The details" at the top of a new page.
A video
Paper can't play a video, so a YouTube or Vimeo link prints as its title, with its address in a footnote at the foot of the page. Both are links in a PDF or on screen. With no title it prints the address alone, on the line.

You get "The lake walk", and the video's address at the foot of the page. To let people scan it from the
page, turn on A QR code beside each video in Report settings: every video gets one, and it's off until
you do. It's the VideoQr: true line in the settings file.
For one video to differ from the rest, put {.qr} or {.no-qr} straight after its line:
{.qr}
A QR code
A qr block with a web address prints a QR code people can scan with a phone.
# Join us
::: qr https://jollify.app
:::
You get a QR code that opens the address.
Moving between pages on a phone
On a narrow screen the Pages give up the row of small pages, so each page gets the whole width. Use the arrows above the page to go to the page before or after, or choose a page from the list between them.
Styling something on the page
Click anything on the Pages to get its tools, then Style for its colours, font, size and border. Your Markdown stays as you wrote it: the style is kept beside it, and stays with that block when you add or remove text around it. If you delete the block, its style waits under Unattached styles in case you bring the block back.
You can also move and turn a block with the handles on its toolbar. A moved block still leaves its gap: the text around it stays where it was, so a moved block can sit on top of other words. It stops at the edge of the page, so it can always be clicked again. Reset puts it back.
A paragraph that runs across two pages can be styled and moved here, but its words change in the Writer.
A report is for paper, so a 3D model, a quiz or falling particles copied in from a presentation won't work here: the model and the particles show as nothing, and a quiz is a plain list with its answer ticked. Click one and its tool takes you to it in the Writer. A video prints as its title and a link: see "A video".
A theme for the whole report
Report settings has a Theme gallery: None keeps the report's plain look, then come the built-in themes (Harbour, Meadow, Ember and Slate) and any you've made. In the Outline, Theme under Look opens the same place, and Brand puts your organisation's colours, fonts and logo on top. To make your own theme, go to the Assets tab on the home page and choose New under Themes. The same theme works on presentations and websites too.
From a Word document
A report you already have in Word comes in as it is: on the Dashboard, choose New, then Open a file… and pick
the .docx (or drop it on the Dashboard). Each Heading 1 becomes a chapter, and its words, lists, tables, pictures,
links and footnotes come with it. The report's theme decides the look. A list of things to check opens beside the
report, naming anything that didn't come across exactly, such as a text box or a comment. An older Word file (.doc)
has to be saved as a .docx in Word first.