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
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Asked May 24, 2018 in Confluence

What are the resources that you use to learn more about Atlassian Products?

I am gathering information about resources available for Atlassian product knowledge transferring for a presentation in our local Atlassian User Group. I want to group them in four categories From ...

604 views 18 16
View question

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