Skip to content

Unrecognized class

Keystone knows every class it can handle — the handler classes, your shortcuts, and a short list of Pandoc-native ones. A class that matches none of them is almost always a typo, so Keystone names it and suggests the nearest real one.

What it looks like

::: {.vspcae size="medium"}
:::

WARN: Unrecognized class 'vspcae' — not a handler, shortcut, or Pandoc-native class.
  Did you mean 'vspace'? (in .vspcae)

What it means

The class vocabulary is closed — there is no author CSS channel, so a class that resolves to nothing can only be a mistake. This is a warning, not an error: the element still builds, so the bogus class leaks into your book unstyled. Under strict mode it becomes fatal, which is why a strict build before publishing is worth the habit.

How to fix

  • Take the "Did you mean?" suggestion when it names what you intended.
  • Otherwise, check the spelling against the system shortcut reference and your own shortcuts.yaml.
  • If the class is genuinely yours, it needs a shortcut or handler that defines it — Keystone won't style a class it doesn't know.
  • Unrecognized attribute — the same idea, one level down: a recognized class carrying a name it doesn't accept.