Theming and dark mode

Roughly half your readers may be in dark mode. A diagram drawn on white either adapts or glares.


#The options

Setting

What it does

Use when

Inherit

Follows the space default.

Almost always.

Enabled

The diagram adapts for dark readers.

Line drawings and text-based diagrams.

Disabled

The diagram keeps its own colours.

Brand colours, or anything where colour has meaning.

#Light Mode

image-20260907-075826.png

#Dark mode

image-20260907-075904.png

#A few things that catch people out

  • Adaptation adjusts colours; it does not redraw the diagram. A dark-on-dark drawing stays hard to read.

  • Excalidraw and draw.io handle dark differently, because one is a sketch and one is a drawing.

  • Exported images use the light rendering, since a PDF has no theme.



Readable in both themes, without redrawing anything.