Heading 1 to 6 is not displaying as it should, with weird behavior?

Question

Hello,

I just started creating PDF templates for export using Scroll PDF Exporter but it is not displaying the Heading 1 to Heading 6 styles as how I had defined them in the template editor.

In the image below, Heading 1 to 6 are rendering properly as it should in the preview window:

I then created this page using Heading 1, 3 and 6 like so:

But after exporting the PDF, this is how the heading got rendered. Heading 1 seems ok, but Heading 3 and Heading 6 font sizes doesn't look correct. Also, Heading 6 which should not have a Left Border got rendered with the border. It almost feels like it rendered Heading 1 2 and 3!

Then here's the weird behavior, if I add all 6 heading styles in the page, only then does it render correctly:

Hope someone can help me with this as I have been scratching my head for days trying to figure it out. The display error is more amplified when I set "Page break before: To next page" in Heading 1 section, no matter what heading style I use (1 to 6), they all get displayed as Heading 1 size at the top of every page.

Thank you so much for any help!

Cocoy Suguitan · Answer

Thanks Thomas! This "hack" can address my requirements for now.

Tom Rough · Answer

Hi @Cocoy Suguitan, the issue you describe relates to how the headings are handled by Scroll PDF Exporter, which is expected behaviour. This is because Confluence does not enforce proper ordering of headings (heading 3 can come before heading 2 on a page, etc.), therefore our Exporters use an algorithm to create a sensible hierarchy in every case.

To do this, Scroll PDF Exporter will set the highest level of heading on a page, when it detects the first heading. Therefore, your heading level 3's and 6's will be elevated to heading level 2's and 3'd respectively. You can find more information regarding the way in which heading are handled here: https://help.k15t.com/scroll-pdf-exporter/latest/server/how-headings-are-handled-165944478.html

To prevent the unexpected formatting of your heading level, you would either need to add the prior heading levels (e.g. level 2 before your heading level 3) on the page, or alternatively, you would need to apply the necessary styling that you have for Heading level 3 and 6, to your Heading level 2's and 3's in your custom export template.

I hope this makes sense.

Cheers, Thomas