book-pdf-pagedjs

Convert the Markdown to HTML with pandoc, assign ASCII ids to headings, build a TOC using CSS target-counter for automatic page numbers, then render with the Paged.js polyfill in Chromium and export via page.pdf with preferCSSPageSize enabled.

Paged.js is a polyfill that implements CSS Paged Media features Chromium lacks natively, such as running headers via string-set, named pages, and target-counter for table-of-contents page numbers. It is loaded as a script tag and renders asynchronously.

The width, height, and format parameters of page.pdf are ignored in some environments and output defaults to US Letter. Set preferCSSPageSize to true and declare the trim size in CSS with @page size, such as 152mm 225mm.

Horizontal flexbox layouts are dropped entirely by page.pdf, leaving blank regions in the output even though screenshots look correct. Replace horizontal flex layouts with display inline-block and vertical-align middle instead.

Yes, pandoc handles EPUB generation directly with pandoc manuscript.md -t epub3 plus options for CSS, a cover image, and a table of contents. EPUB is reflowable, so page numbers and running headers are not needed.

Paged.js renders asynchronously, so calling page.pdf immediately captures an incomplete document. Poll the count of .pagedjs_page elements until it stays stable for several seconds before exporting the PDF.