The short version
- The legacy
page-break-*spellings work. wkhtmltopdf-era CSS (page-break-before,page-break-after,page-break-inside: avoid) is honored as-is alongside the modernbreak-*forms. <thead>repetition is automatic — the header-rows-on-every-page behavior wkhtmltopdf approximated is engine-native here.- Anything outside the subset warns by name instead of rendering differently in silence. Run your template once and read the warnings list — that’s your migration checklist.
What to check
- Headers/footers: wkhtmltopdf’s
--header-html/--footer-htmlflags become@pagemargin boxes withcounter(page)/counter(pages)— see HTML Input → Paged media. - Remote assets: Forme never fetches over the network. Inline images as data URIs or local files; pass stylesheets with
--css. - Fonts: system-font dependence becomes explicit — pass TTFs with
--font Family=path.ttf.
This guide is a stub — it covers the load-bearing differences. If your template hits something unlisted, the render-time warnings will name it; issues welcome on GitHub.