PlantUML colors, zoom and export
How a PlantUML diagram looks in light and dark mode, what readers can do with it on the page, and what Word and PDF exports show.
Colours and dark mode
PlantUML draws a diagram in dark lines on a light background, or in light lines on a dark one. Colours, at the top of the editor, picks which:
- Auto (match Confluence), the default, follows each reader's Confluence: light lines in dark mode, dark lines in light mode. Leave it on Auto unless you have a reason not to.
- Light or Dark keeps the diagram that way for every reader. Where the page is the other way, the diagram sits on a panel of its own, so it stays readable.
Colours you write into the diagram yourself, such as
participant Bob #LightBlue, are drawn as you wrote
them in both modes. Check that they still read well in dark mode.
Zoom, copy and download
Readers hover over a diagram on a published page, and a toolbar appears at its top right. Keyboard users reach it with Tab. It works as for Mermaid diagrams:
- − and + zoom out and in, and Fit shows the whole diagram.
- The full-screen button, or a double-click on the diagram, opens it on the whole screen. Press Esc to leave.
- Copy copies the diagram's PlantUML text.
- Image copies a picture of it, to paste into a chat, an email or a slide.
- SVG and PNG download it as a picture file. A PNG opens almost anywhere; an SVG stays sharp at any size.
Zoom, Fit, full screen and the downloads draw the diagram live, so the first one can take a moment. Downloads are drawn in the colors you see on screen.
A link written into the diagram, such as
[[https://example.org Our handbook]] in a label, can be
selected on the page and opens through Confluence.
A page with many diagrams loads quickly, because the app shows the picture saved with each one where that picture is sharp enough. It draws a diagram live only when it needs to: to zoom, for a link, or when the saved picture doesn't suit the reader's light or dark mode. While it draws, the page may say "Loading the diagram…" for a moment.
Export to Word and PDF
Export the page as you normally would, from More actions (•••) then Export. Each PlantUML diagram comes out as a picture, without the toolbar.
The picture for exports is made when you select Save. If the app can't make it, for example for a very large diagram, the editor says "Not saved yet: no picture for Word and PDF." before saving. You can make the diagram smaller and save again, or select Save without picture. Without a picture, Word exports and page history show the PlantUML text instead of the diagram, and PDF exports draw it live, which is slower.