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

This widget could not be displayed.

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.


This widget could not be displayed.

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}

This widget could not be displayed.

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?

This widget could not be displayed.

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
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Published Jul 30, 2018 in Confluence

How Manon Soubies-Camy uses Confluence + Trello to organize webinar notes and her knitting stash

@Manon Soubies-Camy is an engineer who has been an avid Atlassian user since 2014. She helps companies of all sizes transform the way they work with the Atlassian stack, including Jira and Confl...

858 views 8 13
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