Skip to content

Unrecognized attribute

Each shortcut accepts a fixed set of attributes. An unrecognized one is ignored with a warning, so a typo'd attribute never silently does nothing.

What it looks like

::: {.vspace size="medium" sze="1em"}
:::

WARN: shortcut 'vspace' ignores unrecognized attributes (sze) (in .vspace)
  They match no interface entry.
  Check for typos, or add them to the interface.
  See https://keystone.knight-owl.dev/errors/unrecognized-attribute/

What it means

vspace accepts size, not sze. The unrecognized attribute is dropped; the recognized size still applies, so the build succeeds. The risk this catches is the silent one — a misspelled attribute name that would otherwise be read as "no value given" and change nothing.

Check the spelling, then the shortcut's interface

sze → size catches most of them. Otherwise confirm the attribute exists for that shortcut in the system shortcut reference — and if the shortcut is your own, add the attribute to its interface.