Insert menu

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

The editor's Insert menu adds a starting point for an image or a diagram. From web inserts an image placeholder that points at a Capable illustration, ready for you to swap in your own web address. From code inserts a ready-made Mermaid diagram (graph TD) in a fenced code block for you to edit.

#Worth knowing

Images must be referenced by URL.

#Where to find it

Editor modal > Insert

#Where you do it

Task

Where

Add a diagram

Editor > Insert > From code, or write a fenced block yourself

Add an image

Editor > Insert > From web, or plain Markdown image syntax

#A few things that catch people out

  • There is no upload option in Jira. Replace the placeholder address with a full web address for your image.

  • From code always starts a Mermaid diagram. For PlantUML, Graphviz, D2 or another supported language, change the language after the opening backticks.

  • Diagrams render as images only while you are signed in. Otherwise the block stays as plain code.

How it actually behaves.