# Images & Videos

Adding images and videos to your presentations is as simple as a drag and drop!

The easiest way to add graphics to your presentation is to drag and drop them into the Editor. You can drag them from the Finder or even from your browser. You can also add images to a presentation by copying/pasting.

But first of all, a bit of terminology to understand better this section:

- we will call graphic elements such as an image, a video or a YouTube video.
- we will call container the available space to place the graphic. Depending on the layout, it can be the full slide, a column, or just a cell, in case of a grid.

## Supported formats

### 1. Image 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`

### 2. Video formats

Format | Extension
--- | ---
M4V | `.m4v`
Moving Picture Expert Group 4 | `.mp4`
Quicktime | `.mov`

## Syntax

The traditional Markdown syntax for images is supported but we recommend the simplest Content Blocks Syntax.

You can then simply use the path or URL of the graphic to use then in Presenter.

Presenter uses two special "virtual" folders:

- `/assets/` example: `/assets/image.png` for graphics added to the presentation.
- `Theme` example `/Theme/image.jpg` to reference graphics bundled with a theme.

## The Visuals Tab

The Visuals Tab, available on the right side of Inspector allows you to:

- See all your graphics
- Drag and drop them into the editor
- Delete unused ones
- Rename them

## Controlling graphics

Graphics size and position can be controlled when using the Content Blocks Syntax, using meta-data. You can set them using the dropdown arrow ⬇️ at the end of the graphic definition.

### Sizes

#### 1. Cover

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

#### 2. Contain

The entire graphic is made to fill the available space while preserving its aspect ratio, so the graphic 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 graphic 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 a graphic as a background with other content on top.

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