A marginal note contains additional important but nonessential information. It explains some context, sheds light on a detail or speculates on a given topic etc.

A marginal note should accompany the main text without interrupting it. If the view-port is big enough, it’s placed in the right margin. On mobile view-ports it appears in a box of limited height.

Syntax

The marginal note follows after the content block it belongs to and this is the usual layout order on mobile view-ports. But the note will also be placed besides the next block on large view-ports and that is usually not intended.

To let it float besides the block before, we need to change the layout of this block with the attribute .inline to make room in the right margin.

Longer Paragraph …
{.inline}

{{< mnote >}}
**Public junk dwarves** hug my quartz fox. Zack Gappow saved the job requirement
list for the six boys. Bored? Craving a pub quiz fix? Why, just come to the
Royal Oak! Cozy sphinx waves quart jug of bad milk. Quads of blowzy fjord 
ignite map vex’d chicks.
{{< /mnote >}}

The shortcode is called mnote and needs an opening and closing tag around the note. The note can contain only inline styling and no headings etc.

The shortcode has four named parameters:

star
Number of stars to show at the beginning of the note. 1 or 2 are possible.
dagger
Kind of dagger to show at the beginning of the note. 1 or 2 crossings are possible.
up
Number of units (1rem) to push the note up. The default line height for this theme is three units. We can move the note up in case we can’t use {.inline}.
down
Number of units (1rem) to push the note down. This is the way to make room for absolute positionend layout elements (like the featured image) in the margin before the current note.

Optional stars or daggers should be matched by similar signs in the main text. They are used to reference notes which can’t be placed in the vincinity of the text they are referring to because other layout elements got in the way.

A star is the usual asterisk * on the keyboard. A dagger corresponds to the entity &dagger; and a double dagger to &Dagger;.

Layout

The theme distinguishes between short and long marginal notes. On screens with a right margin, their layout is identical. On smaller ones, the long notes are partly hidden and can be expanded.

Short Note

Cozy lummox gives smart squid who asks for job pen. Quads of blowzy fjord ignite map vex’d chicks. Grumpy wizards make toxic brew for the evil queen and jack.* Jumpy halfling dwarves pick quartz box. Quads of blowzy fjord ignite map vex’d chicks. Five jumping wizards hex bolty quick. Fake bugs put in wax jonquils drive him crazy. Just poets wax boldly as kings and queens march over fuzz.

Long Note

Boxers had zap of gay jock love, quit women. A very bad quack might jinx zippy fowls. Pack my box with five dozen liquor jugs. Fox dwarves chop my talking quiz job. DJs flock by when MTV ax quiz prog. J. Fox made five quick plays to win the big prize. The quick brown fox jumped over the lazy dogs. “Now fax quiz Jack!” my brave ghost pled. The wizard quickly jinxed the gnomes before they vaporized. Fickle bog dwarves jinx empathy quiz. The five boxing wizards jump quickly. Quirky spud boys can jam after zapping five worthy Polysixes. Bawds jog, flick quartz, vex nymph. By Jove, my quick study of lexicography won a prize. The quick onyx goblin jumps over the lazy dwarf. Quick brown fox jumps over the lazy dog.