Keep together in PDF export

Has anyone had any success developing a user macro that will allow you to put the content inside it and ensure that on PDF export, there are never any page breaks within it. Often, we want to make sure specific text and an image always remain together when generating documentation.

We have a pagebreak user macro. But, this keep together macro is provides better support such that you don't have to keep testing your exports, especially as content changes, to insert/correct manual page breaks - it's alot less overhead to maintain your exports, especially with ever changing content.

4 answers

Hello Karie

You could try something like

<div style="page-break-inside: avoid;">

if you don't need extra functionality provided by the Adaptavist plugin.


I did try something like this, but could never get it to work correctly:

## Macro name: keep-together
## Has body: YES, Unprocessed
## Generates: WIKI markup
### Requires: adaptavist-plugin-contentFormattingMacros (div macro)
{div:style="page-break-inside: avoid;"}${body}{div}

I don't know the correct syntax for the user macro. But perhaps this is not the real problem.

Support for "page-break-inside" is limited on the browser side. Especially the value "avoid" seems not to be supported by Firefox, Chrome, and Safari (at least it is said so here). So perhaps this could cause your problems?

I hadn't realized that avoid wasn't supported, which, as you indicate, is probably the reason it is being ignored (I'm a mac user, so don't use IE). Are you aware of any other options?

I am not aware of any real good solutions. I played around with different combinations of "page-break-before" and "...-after" plus manual page breaks. But I never managed to find a solution that would always work.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Dec 18, 2018 in Confluence Cloud

Happy holidays from our team to yours!

Hi Community!  2018 was filled with changes for our team, both big and small, and we've taken a lot of time to both celebrate our wins and recognize areas of improvement. One thing that we're a...

473 views 3 18
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you