Kroki diagram gateway

Diagrams written in markdown code blocks are turned into static SVG images by the Kroki diagram service, rather than drawn in the reader's browser. Rendering needs a Capable client token.

Running your own renderer isn't available at the moment. Every markdown diagram goes through the Capable gateway, whatever your saved Diagrams setting says.

Tikz diagrams that use LaTeX commands to read or write files (such as \input, \include, \lstinputlisting, \openin and \write) are rejected with a security error.


#Where you do it

Task

Where

Insert an image or diagram from the Capable library

Editor toolbar → + → Image 'From library' or Diagram 'From library'

Draw a diagram inline

Editor toolbar → + → Diagram 'From code', then edit the code block

Publish markdown to a static site

Capable Sites (Suite or the Sites app)


#Settings that affect this

Setting

Where

What it does

Global settings → Permissions

-

Controls who can edit the Global library, and so who can create Global markdown templates. The setting is shared with diagrams, images, calendar and search.


#Limits that apply here

Limit

Value

What happens

AI diagram repairs per generation

3

Only the first three diagram blocks in a generated document are checked and repaired. Later blocks, and any language outside the seven that can be repaired, are left exactly as generated.



Better with company.