# 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

Content copied to clipboard

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}

Content copied to clipboard

#### Return

a wrapped Figure or Image node, depending on figure

#### Parameters

url

path or URL to the image

label

- Likely named

inline content used as the image's alt text

title

- Optional
- Likely named

optional inline content used as both the tooltip and figure caption

width

- Optional
- Likely named

optional width constraint for the image

height

- Optional
- Likely named

optional height constraint for the image

ref

- Optional

optional ID for cross-referencing via reference

figure

- Optional

whether to wrap the image in a Figure block

mediastorage

- Optional

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