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.