Images

Add images to your presentation quickly with a drag and drop or a copy/paste. You can control their size and position, apply filters or change the opacity.

Both local images and images from the web are supported in Presenter for Mac.

Note that in the article below, we will call container the available space to place your images. Depending on the layout, it can be the full slide, a column, or just a cell, in case of a grid.

Supported Formats

Format	Extension
Portable Network Graphics	.apng, .png
Graphics Interchange Format	.gif
WebP	.webp
Joint Photographic Experts Group	.jpg, .jpeg
Tagged Image File Format	.tif, .tiff
Scalable Vector Graphics	.svg
Portable Document Format	.pdf

Syntax

The traditional Markdown syntax for images ![](image.png) is supported but we recommend the simplest Content Blocks Syntax.

You can then simply use the path or URL of the image you want in Presenter. Presenter uses two special “virtual” folders:

• assets for graphics added to the presentation, e.g. /assets/image.png
• Theme to reference graphics bundled with a theme, e.g. /Theme/image.jpg

The .iapresenter file is a format (actually a .zip file) containing your markdown presentation file and all your images. There is no need to store your images aside from the presentation. You can manage them using the Visuals Tab of the Inspector (see below).

If you are always using the same images, you could add them into a custom theme in order to avoid duplication in each presentation.

The Visuals Tab

The Visuals Tab can be found on the right side of the Inspector (right panel). If you have closed the Inspector, you can open it in 3 different ways:

• Menu → View → Show/Hide Inspector
• with the shortcut ⌥⌘I
• by a swipe on your trackpad (2 fingers) from the right edge to the left

The Visuals Tab allows you to:

• See all your graphics (images & videos)
• Drag and drop them into the Editor
• Delete unused ones
• Rename them (don’t forget the extension at the end, e.g, .png)

Controlling Images

Images size and position can be controlled when using the Content Blocks Syntax, with meta-data (not available with the Markdown syntax).

You can set them using the dropdown arrow ⬇️ at the end of the image’s path.

If you prefer keeping your hands on the keyboard, you can type the commands instead, for example:

• size: contain
• x: left
• y: bottom
• background: true
• filter: lighten
• opacity: 50%

Either selected from the dropdown arrow or typed manually, images options will appear as such in the Editor:

/Theme/image1.jpg
  filter: sepia

Sizes

1. Cover

The image is resized to entirely cover the available space while preserving its aspect ratio. If it does not match the aspect ratio of its container, the image will be clipped.

2. Contain

The image should fill the available space while preserving its aspect ratio, so it will be “letterboxed” if its aspect ratio does not match the aspect ratio of the container.

Positions

It is important to know that vertical or horizontal positions are only available depending on the aspect ratio of the image and its container.

You have the choice between:

• Center (default), Left and Right for Horizontal Alignment
• Center (default), Top and Bottom for Vertical Alignment

The image will be by default a foreground element, “Content” (sharing space with other elements such as titles) but you can turn it into a background.

Filter and Opacity

You can add filters (Lighten, Darken, Grayscale, Sepia, Blur) to your images or opacity. Those options are useful when using an image as a background with other content on top.

Finally, to have your images shine at their best, don’t hesitate to play with all the different Layouts of Presenter.

Captions

To display captions, use a combination of an H4 heading and an image. The positioning of the caption depends on the order in which you place those elements. No matter the order you choose, the size of the caption stays the same.

• The H4 heading first lets you introduce or provide a brief description of the image that follows.
• The image first allows the visual to be presented prominently, with the caption providing additional information or context beneath it.

💡 If you want a smaller caption text, write your caption in straight quotes after the image/file such as /image.jpg "This is your caption".

The captions/source quotes will be added as a small semi-transparent box in the lower left corner of the file.

Note that this is only available for images added with the Content Block syntax and it is not supported yet for Background images.

Visuals