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.

Try it in Jollify

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.

Try it in Jollify

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}

Try it in Jollify

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.
:::

Try it in Jollify

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.

![The team at the summer camp](https://jollify.app/images/logo.svg){.bleed}

Try it in Jollify

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.
::::

Try it in Jollify

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.
:::

Try it in Jollify

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** |
:::

Try it in Jollify

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 |
:::

Try it in Jollify

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" } ] }
:::

Try it in Jollify

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.

Try it in Jollify

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.

Try it in Jollify

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.

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

Try it in Jollify

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:

![video: The lake walk](https://youtu.be/dQw4w9WgXcQ){.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
:::

Try it in Jollify

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.

Title, description and author in a package

The first time you choose Export, then Package (.jollify), Jollify asks for the report'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 a thumbnail: a picture the report uses, 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 and author are the report's settings too, and the dialog offers to write them there; the description stays in the package.

To put the report in a package with other documents, open its ⋯ menu on Documents and choose Add to package… (see "Put several decks in one package" in the presentation guide: a package takes reports, websites and venues too). The package keeps its own copy; Play in the package editor shows it.