Insert images

Insert images content block

You can insert full-width images into your space, which can be aligned to the left, center, or right. You can optionally include alt text and/or a caption. For accessibility purposes, we highly recommend setting alt text.

Example of an image block

Image blocks can display a gallery of images, like this:

Each image

can have its

own caption

You can now convert image blocks to full width by clicking on the next to the block. Read more about full-width blocks.

Resizing

Hover over your image, and you'll see the SIZE control appear in the top-right corner. Click on it to change the size of your image from the available options.

• Full - removes all size specifications and displays either a full size or capped at a maximum width of 735 pixels for larger images

• Small - 25% of the image size

• Medium - 50% of the image size

• Large - 75% of the image size

In the event that the image exceeds the size of the editor, the image's width will be limited to the ratio of the editor's width instead.

When it comes to resizing images in an image gallery, the process and results can differ from resizing single images.

Resizing images through Git Sync

If you want more control over the sizing of your image, you can specify the exact size using markdown in GitHub or GitLab.

When we export an image, we use the HTML tag <img/>. As per the specifications, we can specify the dimensions of the image using the width and height attributes, which only accept values in pixels or a combination of a number and a % sign. Valid variants of specifying the image dimensions are: <img width="100" /> <img width="100%" />

Related

If you are looking to embed external content into your pages, take a look at how to embed a URL.

Git Sync representation in Markdown

//Simple Block
![](https://gitbook.com/images/gitbook.png)

//Block with Caption
![The GitBook Logo](https://gitbook.com/images/gitbook.png)

//Block with Alt text
<figure><img src="https://gitbook.com/images/gitbook.png" alt="The GitBook Logo"></figure>

//Block with Caption and Alt text
<figure><img src="https://gitbook.com/images/gitbook.png" alt="The GitBook Logo"><figcaption><p>GitBook Logo</p></figcaption></figure>