Skip to content

Resize of image in documentation #964

Open

Description

@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.

Image

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 :-(

Activity

  1. mportiz08 commented on Aug 26, 2025

    @mportiz08
    Member

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions