Skip to content

Unrecognized font family

fontfamily names a value that isn't a font-registry key. Keystone warns and, on PDF and EPUB, falls back to latin-modern, so a lenient build still produces its artifact; under strict mode it stops.

What it looks like

fontfamily: garmond

WARN: fontfamily 'garmond' is not a registry key; falling back to latin-modern
  See https://keystone.knight-owl.dev/errors/unrecognized-fontfamily/

What it means

fontfamily must name a font in the registry — a built-in font or one you've registered. On PDF and EPUB, an unrecognized value falls back to latin-modern, which keeps output stable across engine and Pandoc versions. DOCX and ODT take their fonts from the reference document, so there is no fallback — the warning drops the falling back to note.

Check the spelling, or register the font

The built-in fonts are the names the registry knows; a font of your own is registered first.