pdf

Define paper size and margins with an @page CSS rule, use mm and pt units instead of vh or vw, and add page-break hints to headings and tables. The pdf-builder MCP App renders the HTML directly to PDF using headless Chrome.

Apply break-after: avoid to headings and break-inside: avoid to tables, figures, and blockquotes so they are not split across pages. Insert an explicit page-break-before: always class only at major section boundaries or after a cover page.

Use mm or cm for layout dimensions and pt for font sizes, since vh and vw are undefined in print contexts. Pixels are acceptable only for borders and small border radii.

Setting an explicit body width overrides the @page margin box and breaks automatic pagination. Let the @page margins define the content area and never constrain the body width in print stylesheets.

Native CSS page numbers via @page @bottom-center with content: counter(page) work in Chrome when printBackground and @page rules are honored. The more reliable pattern is placing metadata inline at the end of the document body in a muted style.

Browsers strip background colors in print by default. Add print-color-adjust: exact (and the -webkit- prefixed variant) to the body so colored backgrounds are preserved in the rendered PDF.