A macro is missing from a PDF

When you export a page to PDF, Confluence asks each app for content it can export. If a macro does not offer any, it is simply left out of the PDF.

Several Formatting macros are in exactly that position.


#What to do

  • Check the export support matrix. If the macro is listed as not exported, the PDF is behaving correctly.

  • Publish to a Capable Site instead. Coverage there is much better and links keep working.

  • Or add a plain Confluence equivalent alongside the macro, so the PDF still carries the content.


#A few things worth knowing

Here is the difference in practice, with two macros as they appear in a PDF export.

Color palette macro in a PDF export, a table of Primary, Secondary and Tertiary swatches with their hex codes
The Color palette macro comes through an export intact, swatches and hex codes included.
LaTeX macro in a PDF export, showing the raw equation source in a code block instead of the rendered equation
The LaTeX macro does not. The PDF shows the equation source rather than the finished equation.
  • An image missing from an export is usually a different problem: an external image the export could not fetch.

  • Site export is richer than PDF export and behaves differently for some settings.

  • Exporting never changes the page itself.



Check the matrix. It is probably expected.