Setting a page break for PDF export
Asked by Jonathan Lake:

Hi, I am a newbie with page styles and pdf exports and so I'd appreciate some help with exporting pages to PDF and correctly using page breaks.

I would like to use an image or (ideally) a hidden element of the page content to force a page break when exporting to PDF. I have seen style sheet code which breaks on h1, h2 etc.... but I don't know what h1, h2 etc are.

Ideally I would like to be able to insert a user macro at the point I want the page to break when exported. When viewing it would remain invisible.

Please be gentle in pointing out the scale of my ignorance.

Regards, Jon


Answers:
author: Ale? La?ar
body: Hi Jonathan.

H1 etc is HTML tags (paired) It is tag for Headings. H1 is top level heading, h2 second one ....

*H1* tags, *p* tags etc is blocked, so everytime is there break new line after them.

If you need break, use \<br\> tag.

HTML is covered by W3 Consorcium. They have many examples and tutorials and really awesome web [](http://www.w3schools.com/html/html_basic.asp)<http://www.w3schools.com/html/html_basic.asp>

If you need a new page, you have to use styles for it. It is called CSS (Cascade Style Sheet), more info on w3 web :)

If you have some element (HTML tag) on page, for example H1, and you want to have it on a new page , you can create class in CSS, define there that page breaking, and then use H1 with class definition of breaking. Examples :)

```
&lt;style&gt;.break { page-break-before: always; }&lt;/style&gt;&lt;body&gt;content on page 1...&lt;h1 class="break"&gt;text of Heading 1 on page 2&lt;/h1&gt;content on page 2...&lt;h1 class="break"&gt;text of Heading 1 on page 3&lt;/h1&gt;content on page 3...&lt;p class="break"&gt;content on top of page 4&lt;/p&gt;content on page 4...&lt;/body&gt;
```

And here it could be for ALL H tags :)

```
&lt;style&gt;h1{ page-break-before: always; }&lt;/style&gt;&lt;body&gt;content on page 1...&lt;h1&gt;text of Heading 1 on page 2&lt;/h1&gt;content on page 2...&lt;h1&gt;text of Heading 1 on page 3&lt;/h1&gt;content on page 3...&lt;/body&gt;
```

comments: author: Jonathan Lake
body: Thanks for this, I can see some study is in order. You've helped me a great deal.


author: Ale? La?ar
body: I hope that It will help you :) If you need any advice in CSS, write comment here :)

Have a nice day!


author: Markus
body: You could do the + trick :)

```
hr + hr {

  page-break-before: always;

}
```

So you can do a single hr when you want it.

If you take two hr in a row, the page-break will formated as needed.


author: Shannon Nicholas
body: Hi [@Markus](/t5/user/viewprofilepage/user-id/1957616)

Can you please elaborate? Got the same issue. TIA

Cheers


author: Markus
body: Hi [@Shannon Nicholas](/t5/user/viewprofilepage/user-id/3517275)

you put the hr + hr definition from above in your customized CSS-file for the export.

After that you can get a manual page-break with two hr in a row at the export.

Cheers


author: Shannon Nicholas
body: Hi [@Markus](/t5/user/viewprofilepage/user-id/1957616)

Thanks a bunch


author: Debabrata Sen
body: [@Markus](/t5/user/viewprofilepage/user-id/1957616) hr means divider right ?? But it causing me an under line which i don't want


author: Steven John
body: That last answer works well and is the simplest. In steps it is:

1. Edit the confluence page then place the cursor at the line where you need a page break
2. Select the plus sign to insert more content then select **Other Macros**
3. In the left hand filter column, select **formatting** then**div**
4. In the Style field paste in the following:**`page-``break``-after:always;`**

comments: author: Phillip Yero
body: I am relatively new to using Confluence, so please pardon my ineptitude. When I click "Formatting", I don't see "div" as an option. Listed alphabetically, it goes from "CSV" to "Expand". Is there something I need to do first to be able to see it? Have they removed this as an option since this post?


author: Steve
body: Thank you for this! I've been looking for this solution for a while. :)


author: Paula Amaral
body: Steven, good morning,

This is a very old post but today helped me a lot. Thank you so much for that.


author: BenoitP
body: Insert, anywhere you want the page break to happen, a "Div" macro with the "Style":

```
page-break-after:always;
```

comments: author: Hamish Willee
body: FYI, this still works (May 2017). I particularly like it because unlike other "solutions" here, it doesn't require you to have access to create user macros or edit stylesheets.


author: Nir Mazor
body: Yep, still works. I wish there was a way to achieve the same result globally for all pages, without using any macros. Seems like it should be a simple enough option.


author: Allie Fabian-Orris
body: I second Nir! How is this not native to Confluence?


author: Yana encheva
body: This doesnt seem to work when i try to Export using the Browser "Print as PDF" setting. Does anyone know how i can achieve that?

The reason why i dont export as PDF using the Confluence Option is because it doesnt pull my Jira graphs (it just pulls the iframe query text)

PS i am a newbie here so please bear with me.


author: Glyn
body: Wow, this shouldn't be so hard. Or am I missing something?


author: GG
body: Hi Jonathan.

Content Exporter for Confluence addon has a built-in page break macro. That should be an easy fix for your question:

<https://marketplace.atlassian.com/plugins/com.metainf.confluence.plugin.pagetreeexporter.pagetree-word-exporter-plugin/cloud/overview>


author: EPS Software Engineering AG
body: Hi Jonathan,

You could use the [OneOffixx Exporter App](https://marketplace.atlassian.com/apps/1220419/oneoffixx-exporter-word-pdf-export?hosting=server&tab=overview) for Confluence. There are macros for page breaks, portrait, landscape, etc.

You can find it on the Marketplace and there is also a link to our example page, where you can test the app easy and fast.

Regards,  
Stephan (CEO of EPS Software Engineering AG, the vendor of the OneOffixx Exporter)


author: Jordan Witt
body: I realize this question is ancient, but I couldn't find that they've ever come up with a better way to solve the problem and was able to make BenoitP's solution work with some modification.  

I wanted to add that **div** is no longer available under **Other Macros** -\> **Formatting** , and instead replaced with **Divbox** . Adding *page-break-after:always;*still works, but the Divbox will display an empty tan colored box with a border.

To get rid of the tan background and the border, you'll now want to enter this into the style field.

*page-break-after:always; background-color:transparent; border: 0px*

Now you'll have an invisible page break that will format your PDF's the way you want them to.

comments: author: Andrew Keohane
body: Thanks for posting this Jordan. I'm using the Cloud version and Div is still available, but it wasn't working for me, until I read the text for the Div command which says about *wrapping* the selected text in the Div. I put the cursor at the end of the page, selected all the page content and *then* inserted the Div and it worked. I had one page containing a table which refused to play ball, and kept replacing the selected text with the Div so I had an empty page (!) but apart from that, all good.


author: joshuastinson
body: Benoit thank you for taking the time to post this. This worked for me.


author: Nils Bier _K15t_
body: Hi Jonathan,

if you are using our [Scroll PDF Exporter](https://marketplace.atlassian.com/plugins/com.k15t.scroll.scroll-pdf), you can create a user-macro to insert page-breaks. The usermacro is not visible in the Confluence view, but will be inserted when exporting to PDF.

Please have a look at the following page for further details how to create this macro: [Adding Pagebreaks](https://www.k15t.com/display/PDF/Adding+Pagebreaks).

Besides you can simply define page breaks using CSS, e.g. to always break before a heading 1 (h1), see [Enforcing Pagebreaks](https://www.k15t.com/display/PDF/Enforcing+Pagebreaks).

Hope that helps.

If you have any further questions regarding Scroll PDF Exporter, please feel free to contact [](mailto:support@k15t.com)[support@k15t.com](mailto:support@k15t.com). I'll be happy to help.

Cheers,  
Nils


Tags: export

layout

page

pdf