---
description: "Getting images into a Jotaid note: paste directly, pick a file, or point at a URL — and how images are stored as attachments."
---
<!--
  Markdown representation of https://docs.jotaid.com/en/guide/insert-images
  Generated by scripts/gen-markdown-variants.mjs — do not edit by hand.
  Served from the canonical URL under `Accept: text/markdown`.
-->

# Insert Images

## Paste (fastest)

Copy any image and press **⌘V** in the editor. Jotaid compresses it, stores it as an attachment of that note, and writes a line of Markdown at the cursor.

Screenshots, images from a web page, images from another note — all take this path.

## From the Toolbar

Press **⌘⇧M** (or click the image button) and Jotaid asks where the image comes from:

- **Choose File…** — opens a file picker; the file is stored as an attachment
- **Enter URL** — type an address and it is written as `![](url)`, leaving the image where it lives

## Syntax

```markdown
![alt text](path-or-url)
```

The square brackets hold the alt text — shown when the image cannot load, and read aloud by screen readers. The parentheses hold the path or address.

## Loading and Failures

Image attachments render in place in the editor. While one is still decoding you see a spinning placeholder; if the file is damaged or missing, the placeholder simply stays rather than breaking the note. The original line of Markdown is always still there, ready to be edited or deleted.

> **Attachments belong to the note**
>
> Images added by pasting or by picking a file are **attachments of that note** and are cleaned up when the note is deleted. An image inserted by URL is not an attachment — whether it displays depends on that address still being there.

Attachments travel with a Markdown export; see [Import & Export](https://docs.jotaid.com/en/guide/import-export).

## Next Steps

- [Insert Tables](https://docs.jotaid.com/en/guide/insert-tables) — The other block that renders in place
- [Note Formatting](https://docs.jotaid.com/en/guide/markdown-editor) — The toolbar and base syntax
