Obsidian Pagebreaks

obsidian-pagebreaks.css

/*
 Create pagebreaks in exported Obsidian PDFs.

Rules:
- Convert ALL hr to page breaks.
- Page break before h1 and h2, except for the h1 on the first page.
  This should now work correctly
- Don't break immediately after a heading.
- Don't break in the middle of preformatted text or blockquotes.
- Avoid splitting up h1 immediately followed by h2 etc.
*/

@media print {
  /* Avoid page breaks on first page for h1 */
  div:has(pre.frontmatter)+div:has(h1) h1 {
    break-before: avoid;
  }
  /* Break before each h1 and h2 heading */
  h1, h2 {
    break-before: page;
  }
  /* Avoid splitting adjacent headers  */
  div:has(h1)+div:has(h2) h2,
  div:has(h2)+div:has(h3) h3,
  div:has(h3)+div:has(h4) h4,
  div:has(h4)+div:has(h5) h5,
  div:has(h5)+div:has(h6) h6 {
    break-before: avoid;
  }
  /* Avoid breaks directly after headings */
  h1, h2, h3, h4, h5, h6 {
    break-after: avoid;
  }
  /* Avoid breaking in the middle of a pre or blockquote */
  pre, blockquote {
    break-inside: avoid;
  }
  /* Convert hr to page break and hide it */
  hr {
    visibility: hidden;
    break-before: page;
  }
  /* Set background to white for better printing */
  body {
    background-color: white;
  }
}

Thanks for this update, I indeed took inspiration and I updated to include:

• Natural page breaks at A4 boundaries (no forced breaks at headings)
• Headings never stranded at bottom of page (widow protection)
• Paragraphs that would end near the bottom move to the next page instead
• Code blocks, tables, images, and callouts never split across pages
• hr elements converted to explicit page breaks
• Manual page break: type > [!pagebreak] anywhere in your note
  • Invisible in reading view, forces a page break in PDF export
  • Can be used as many times as needed
  • All clean-break rules apply from that point forward