Images

The block image macro (image::[]) and the inline image macro (image:[]) accept SVG, PNG, JPG/JPEG, and GIF file formats.

Insert a block image

Block images, indicated by two colons (::), are entered on their own line and displayed on their own line. Optional attributes and values are entered inside the macro’s attribute list ([]). If the macro’s attribute list is empty (e.g., image::filename.jpg[]), the image is displayed at its original size and centered on the page.

Block image
image::intellij-install-location-dialog-box.png[]

The example above is published as:

intellij install location dialog box

To adjust the size and position of an image, you use the macro’s attributes. In the block image with attributes example, the first positional value is empty, so the opening square bracket ([) is directly followed by a comma (,). The second positional value, 280, indicates the maximum width of the image. The next attribute, align, and its assigned value center, places the image in the center of the visitors screen.

If the macro’s attribute list is empty (e.g., image::filename.jpg[]), the image is displayed at its original size and centered on the page.

Block image with attributes
image::intellij-install-location-dialog-box.png[,280,align=left]

The example above is published as:

intellij install location dialog box

Insert an inline image

The inline image macro, indicated by a single colon (:), is used for displaying small images and icons directly in the flow of a sentence.

Inline image
Click the image:git-branch.svg[,16] icon.

The example above is published as:

Click the git branch icon.