> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autype.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Images

> Embed images with sizing, alignment, captions, and anchors — using standard Markdown or the image directive.

## Standard Markdown

```markdown theme={null}
![Alt text](image.png)
![Alt text](image.png "Hover title")
```

The alt text is automatically used as the **figure caption** for auto-numbering in the List of Figures.

## Extended attributes

Append `{attrs}` after the image to control size, alignment, and more:

```markdown theme={null}
![Company Logo](logo.png){width=200 height=100 align=center}
![Photo](photo.jpg){width=400 align=right spacing=10,20}
```

### Auto-captioning

The alt text becomes the figure caption:

```markdown theme={null}
![Sales Dashboard 2024](dashboard.png){width=600 align=center}
```

This renders as: *Figure 1: Sales Dashboard 2024*

The caption prefix (e.g., `"Figure"`, `"Abb."`) and styling (font, alignment, color) are configured in your document's [style settings](/getting-started/editor/sidebar-styles#figure-captions).

Override the caption explicitly:

```markdown theme={null}
![](chart.png){width=400 caption="Revenue by Quarter"}
```

### Anchors for cross-references

Add an `anchor` attribute to reference the image from elsewhere:

```markdown theme={null}
![System Architecture](diagram.png){anchor=fig-diagram width=600}
```

Then reference it:

```markdown theme={null}
See [Figure {num}](#fig-diagram) for the architecture overview.
```

<Tip>
  See [References & Anchors](/markup-reference/references) for all cross-reference options.
</Tip>

## Attribute reference

| Attribute | Values                         | Description                          |
| --------- | ------------------------------ | ------------------------------------ |
| `width`   | Number (pixels)                | Image width                          |
| `height`  | Number (pixels)                | Image height                         |
| `align`   | `left`, `center`, `right`      | Horizontal alignment                 |
| `caption` | String                         | Override caption (default: alt text) |
| `anchor`  | String                         | Anchor ID for cross-references       |
| `spacing` | `before,after` (e.g., `10,20`) | Spacing before/after in points       |

***

## Image directive

For an alternative syntax, use the `:::image` directive:

```markdown theme={null}
:::image{width=300 height=200 align=center}
![Product Image](product.png)
:::
```

```markdown theme={null}
:::image{width=150 align=left}
![Thumbnail](thumb.png)
:::
```

The directive supports the same attributes as the inline syntax (`width`, `height`, `align`, `caption`). The alt text from the inner `![alt](src)` is used as the caption if no explicit `caption` attribute is provided.