Put something akin to the following at the start of your .typ file:
#import "@preview/marginalia:0.1.3" as marginalia: note, wideblock
#let config = (
// inner: ( far: 5mm, width: 15mm, sep: 5mm ),
// outer: ( far: 5mm, width: 15mm, sep: 5mm ),
// top: 2.5cm,
// bottom: 2.5cm,
// book: false,
// clearance: 8pt,
// flush-numbers: false,
// numbering: /* numbering-function */,
)
#marginalia.configure(..config)
#set page(
// setup margins:
..marginalia.page-setup(..config),
/* other page setup */
)If book is false, inner and outer correspond to the left and right
margins respectively. If book is true, the margins swap sides on even and odd
pages. Notes are placed in the outside margin by default.
Where you can then customize config to your preferences. Shown here (as
comments) are the default values taken if the corresponding keys are unset.
Please refer to the PDF documentation for more details on the configuration and the provided commands.
Provided via the #note[...] command.
#note(reverse: true)[...]to put it on the inside margin.#note(numbered: false)[...]to remove the marker.#note(shift: false)[...]to force exact position of the note.#note(shift: "ignore")[...]to force exact position of the note and disable collision.- ..and more
Provided via the #wideblock[...] command.
#wideblock(reverse: true)[...]to extend into the inside margin instead.#wideblock(double: true)[...]to extend into both margins.
Note: reverse and double are mutually exclusive.
Note: Wideblocks do not handle pagebreaks in book: true documents well.
You can use figures as normal, also within wideblocks. To get captions on the side, use
#set figure(gap: 0pt)
#set figure.caption(position: top)
#show figure.caption.where(position: top): note.with(numbered: false, dy: 1em)For small figures, the package also provides a notefigure command which places the figure in the margin.
#marginalia.notefigure(
rect(width: 100%),
label: <aaa>,
caption: [A notefigure.],
)
Have you encountered a bug? Please report it as an issue in my github repository.
Has this package been useful to you? I am always happy when someone gives me a sticker star⭐