90 lines
3.3 KiB
Markdown
90 lines
3.3 KiB
Markdown
# 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).
|