Skip to main content

​
Standard Markdown

The alt text is automatically used as the figure caption for auto-numbering in the List of Figures.

​
Extended attributes

Append {attrs} after the image to control size, alignment, and more:

​
Auto-captioning

The alt text becomes the figure caption:
This renders as: Figure 1: Sales Dashboard 2024 The caption prefix (e.g., "Figure", "Abb.") and styling (font, alignment, color) are configured in your document’s style settings. Override the caption explicitly:

​
Anchors for cross-references

Add an anchor attribute to reference the image from elsewhere:
Then reference it:
See References & Anchors for all cross-reference options.

​
Attribute reference

The optional Markdown image title remains separate from the visible caption:
Crop and focal-point values use percentages. A crop rectangle must remain inside the source image, so x + width and y + height cannot exceed 100.

​
Image directive

For an alternative syntax, use the :::image directive:
The directive supports the same attributes as the inline syntax, including fit, crop, focalPoint, opacity, caption, anchor, and spacing. The alt text from the inner ![alt](src) is used as the caption if no explicit caption attribute is provided.