multi-plot2 directive

Contents

`multi-plot2` directive#

The multi-plot2 directive arranges nested plot blocks in a grid layout. Unlike multi-plot (which takes a list of function expressions), multi-plot2 gives each subplot its own full plot directive — allowing different drawing primitives, styles, and overlays per panel.

Basic usage#

:::::{multi-plot2}
---
rows: 1
cols: 2
---

:::{plot}
function: x**2, f
:::

:::{plot}
function: x**3, g
:::
:::::

Syntax overview#

The container specifies the grid dimensions and shared styling. Each nested plot is a full plot directive.

Options#

Container options#

Option	Meaning	Default
`rows`	Number of grid rows	`1`
`cols`	Number of grid columns	`1`
`width`	CSS width of the combined figure	—
`align`	`left`, `center`, or `right`	—

Shared defaults (applied to all nested plots)#

Option	Meaning
`xmin`, `xmax`, `ymin`, `ymax`	Axis limits
`xstep`, `ystep`	Tick spacing
`fontsize`	Font size
`ticks`, `grid`	Ticks and grid
`lw`, `alpha`	Line width and alpha
`figsize`	Figure size
`xlabel`, `ylabel`	Axis labels
`usetex`	LaTeX text rendering
`axis`	Axis style

Other options#

Option	Meaning
`class`	Extra CSS classes
`name`	Stable anchor / reference name
`alt`	Alt text
`nocache`	Force regeneration
`debug`	Keep debug output

Tips#

Shared options set on the container are inherited by all nested plot blocks but can be overridden per subplot.
Use multi-plot when all subplots share the same structure and only differ by function expression.

Source#

src/munchboka_edutools/directives/multi_plot2.py