image

.image    url:{String} \
label:{InlineMarkdownContent} \
title:{InlineMarkdownContent? = null} \
width:{Size? = null} \
height:{Size? = null} \
ref:{String? = null} \
figure:{Boolean = true} \
mediastorage:{Boolean = true} \
-> Node

Creates an image with fine-grained control over its properties, compared to the standard Markdown image syntax (![alt text](url "title")).

Example:

.image {image.png} label:{An image}

.image {photo.jpg} label:{A photo} title:{A beautiful photo} width:{200px}

Return

a wrapped Figure or Image node, depending on figure

Parameters

url

path or URL to the image

label

inline content used as the image's alt text

title

optional inline content used as both the tooltip and figure caption

width

optional width constraint for the image

height

optional height constraint for the image

ref

optional ID for cross-referencing via ref

figure

whether to wrap the image in a Figure block

mediastorage

whether this image should be registered in the media storage system. When disabled, the image URL is used as-is without being copied to the output's media directory. Useful for images that should reference a fixed relative path rather than a stored copy