> For the complete documentation index, see [llms.txt](https://docs.laws.africa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.laws.africa/markup-guide/marking-up-images.md).

# Marking up images

After working through this section, you should be able to:

* Mark up / insert an image.

The pattern for marking up images is as follows:

* In the text where the link appears, the opening `{{IMG`
* A space, followed by `media/` and the filename of the image
* The closing `}}`.

{% hint style="warning" %}
The filename cannot contain spaces.
{% endhint %}

{% hint style="info" %}
The image needs to be listed under Attachments on the document.
{% endhint %}

### Example

```
PARA 9. 
  Content of paragraph.
  
  {{IMG media/img4.png}}
  

```

## Shortcut

* In Edit mode, with your cursor placed where the image should appear, click **Insert | Insert image …**
* Choose the image from the existing attachments (or add it to this list if it's not there) and click **Insert image**
* The markup described above will be inserted for you automatically.

![](/files/9EfApTqenc5xpPnf9yVk)

![](/files/rXGX2VQlDcvxLZWFX6pU)

![The image markup has been inserted at line 13](/files/RdwmxjJoF7Mfcwv4xaRy)