# 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: ```markdown ## 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: ```markdown 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: ```markdown @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](/docs/characters-and-items). - Pin a note onto a spot on a [map](/docs/maps).