Skip to content

Invalid attribute value

The attribute is one the element accepts, but its value isn't. The handler reports it and falls back. Most of these are warnings; a couple are fatal because a wrong value would break the build rather than just look off.

What it looks like

::: {.vspace size="banana"}
:::

::: {.aside type="todo"}
A callout whose type is not one of the defined kinds.
:::

::: {.multicol cols="9"}
Text that was meant to flow across columns.
:::

WARN: vspace: unrecognized size 'banana' (in .vspace)
  See https://keystone.knight-owl.dev/errors/invalid-value/
WARN: aside: unknown type 'todo'
  (in .aside "A callout whose type is not one of the d…")
  See https://keystone.knight-owl.dev/errors/invalid-value/
WARN: multicol: invalid cols '9'
  (in .multicol "Text that was meant to flow across colum…")
  A cols value is an integer from 2 to 4.
  See https://keystone.knight-owl.dev/errors/invalid-value/

What it means

Each handler validates its own inputs and, on a bad value, drops back to a safe default (or drops the element) so a lenient build still produces its artifact. The message names the handler, the field, and — where the set is small — the accepted values.

Take a value from the shortcut's reference entry

Each entry in the system shortcut reference lists what its attributes accept. For a shortcut of your own, that is whatever its interface defines. A font: value comes from the fonts the image carries.