Resize of image in documentation

[pylapp]

Feature Name

Image resizing

Description

In Swift documentation we can define images to add in pages, with some variants according to this online doc.

However it seems it is not possible to resize images so make them use lower width or height.

For example with a Markdown code for my image I want to have in 100x200:

![A button component in light and dark mode with Orange theme](component_button_enabled_strong_Orange =100x20)

This line is not parsed (see screenshot below) even if the line width size conditions works fine.

Motivation

Be able to resize images to make them use less spaces

Importance

This feature may improve user experience and easy of read.

Alternatives Considered

I did find any alternatives :-(

[mportiz08]

I agree that this would be a great ability to have some control over as an author of documentation without having to create new assets for each set of dimensions.

Making this work however will likely need a coordinated effort with DocC so that the desired dimensions get parsed from the markdown and passed through to the renderer.