PDF and Word export
Export the page to PDF as usual. Each diagram appears in the PDF as a picture, as drawn on the page. It is fitted to the page's width, without the zoom buttons.
- A diagram taller than a PDF page is made smaller so that it fits on one page, as long as its text stays readable (at least 60% of its own size). A diagram that would have to shrink further keeps the page's width and continues on the next page. To keep it whole, split it into smaller diagrams, each in a macro of its own.
- A diagram that fits a page but not the space left on it starts on the next page.
- A diagram you saved in the diagram editor keeps a copy of its drawing, made for printing. If the export comes before the diagram is drawn on the export's page, the export prints that copy.
- A diagram that has no such copy prints as a drawing when it is drawn in time (see Known limits below). If it is not, the export prints the sentence "This diagram was not drawn in time for the export. To have it drawn in every export, open it in the diagram editor and save it.", followed by the first lines of its Mermaid text, never an empty space, and the address of the help page with pictures, peakdevs.eu/mermaid/pdf/. To fix it, open the diagram's editor (Edit) and press Save; for a diagram drawn from a code block on the page, press "Keep drawing the page's code block". See A diagram is missing from the PDF.
- An error panel exports as the error panel, so a PDF never hides a broken diagram. A diagram that has not finished drawing after 30 seconds exports as a panel that says so, so it never stops the export.
- Diagrams in a PDF are always light, also when you use the dark theme.
Known limits
- Confluence takes its picture of the page a few seconds after the page opens, and apps cannot make it wait (Atlassian tracks this as CONFCLOUD-81523).
- A diagram not saved in the diagram editor may print as its text, with a note, on a page with many diagrams. This is a diagram typed straight into the page, drawn from a page code block, or last saved before the app was updated. To fix it, open the diagram in the editor and press Save: see the steps with pictures in A diagram is missing from the PDF.
- A very large diagram may be too large to keep a copy. The editor says so when you save it. Split it into smaller diagrams, each in a macro of its own.
Word
Word export shows the diagram's text, not the drawing: a code block with the caption "Diagram source. The diagram itself shows on the Confluence page." The text keeps your diagram readable and editable in the document.
A macro that draws a code block from the page exports the line "This diagram has no source to export." The page's own code block exports with the rest of the page, so the text is still in the document.
Other exports
Other export types get the diagram text as a code block, as Word does.
Not yet
- A picture of the diagram in Word.
- Downloading a diagram as PNG or SVG.