Files
dragonroll/frontend/app/content/docs/02-using-dragonroll/01-notes-and-markdown.md
Gitea OpenCode Agent 788f69efd3
All checks were successful
Test / test (push) Successful in 2s
Fix issue #79: Implement documentation
2026-10-15 19:07:09 +00:00

3.3 KiB

Notes and markdown

Notes are where a campaign is written down: sessions, NPCs, the lore of a city, the ritual the party found in a dungeon. They are plain markdown, so anything you already know from README files and Obsidian works as it is.

Opening and editing a note

Clicking a note in the sidebar opens it in the note column, where you can have several open side by side. A note opens in display mode, showing its formatted markdown. Press Cmd+E (Ctrl+E) to edit its source, and Cmd+S (Ctrl+S) to save it; a dot in the note's title bar reminds you that there is something to save. The cross in the title bar closes the note — it does not delete it.

Folders

The sidebar's sections hold notes in folders, and folders hold folders, so a campaign can be nested as deep as it needs. Right-clicking gives the commands:

Right-click on… You get
a note Open, Rename, a colour, the folder to move it to, Delete
a folder New note in it, Rename, a colour, Delete folder

Dragging a note onto a folder moves it there, and dropping it at the bottom of the list takes it back to the root. Colouring a note or a folder tints its row in the sidebar, which is a quick way to mark what matters.

Deleting a folder does not delete your notes: the notes it held move up to its parent folder, its sub-folders move up with them, and only the empty folders go away.

Markdown

Headings, bold, italic, lists, quotes, tables, code and links all work:

## The Wreck of the Salt Gull

- [ ] Burn the manifest
- [x] Ask the harbourmaster

| Cargo | Worth |
| --- | --- |
| Salted fish | 20 gp |

Clicking a heading folds the section under it — handy when you are reading a long note on a projector and only want the part you are talking about. Sub-headings fold with their parent.

Rolling dice in a note

A note can hold a dice widget: a button that rolls and shows the result right there, so the book of a spell does not need a second app next to it.

Write @roll and the expression in square brackets to drop it in the middle of a sentence:

The goblin attacks with @roll[1d20+4].

Or in a block of its own, between @roll and @end, when the roll is worth showing on its own line:

@roll
8d6
@end

Either way the widget shows the expression as a button: press it and the dice land, with every die and the total spelled out. Press it again to roll again. Only the expression itself goes between @roll and @end — write the note about the roll next to the widget, not inside it.

The expression understands:

Written Meaning
d20, 1d20 one die; the number in front is how many, so 4d6
d20adv, d20dis roll twice and keep the higher / the lower
4d6kh1, 4d6kl1 keep the highest / lowest one of four (any number after kh / kl)
+, -, *, / arithmetic; 2d6+3, 1d8/2
( ) grouping, as in (1d8+4)*2
-3 a negative number

Division rounds down, the way damage does. Spaces between the parts of an expression do not matter, but a modifier belongs right after the dice: write 4d6kh1, not 4d6 kh 1.

Next

  • Put the people and things of your notes on sheets.
  • Pin a note onto a spot on a map.