Skip to main content

Standard Markdown

![Alt text](image.png)
![Alt text](image.png "Hover title")
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:
![Company Logo](logo.png){width=200 height=100 align=center}
![Photo](photo.jpg){width=400 align=right spacing=10,20}

Auto-captioning

The alt text becomes the figure caption:
![Sales Dashboard 2024](dashboard.png){width=600 align=center}
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:
![](chart.png){width=400 caption="Revenue by Quarter"}

Anchors for cross-references

Add an anchor attribute to reference the image from elsewhere:
![System Architecture](diagram.png){anchor=fig-diagram width=600}
Then reference it:
See [Figure {num}](#fig-diagram) for the architecture overview.
See References & Anchors for all cross-reference options.

Attribute reference

AttributeValuesDescription
widthNumber (pixels)Image width
heightNumber (pixels)Image height
alignleft, center, rightHorizontal alignment
captionStringOverride caption (default: alt text)
anchorStringAnchor ID for cross-references
spacingbefore,after (e.g., 10,20)Spacing before/after in points

Image directive

For an alternative syntax, use the :::image directive:
:::image{width=300 height=200 align=center}
![Product Image](product.png)
:::
:::image{width=150 align=left}
![Thumbnail](thumb.png)
:::
The directive supports the same attributes as the inline syntax (width, height, align, caption). The alt text from the inner ![alt](src) is used as the caption if no explicit caption attribute is provided.