Images in the body

Paste a screenshot or copied image straight into an Entry's body — it appears instantly, syncs in the background, and works offline.


You can drop images into the body of any Entry by pasting from your clipboard. The image shows up the moment you paste — no upload spinner blocking you, no wait — and Kaizendex quietly syncs it to your account in the background so it's there on every device.

How to paste

  1. Copy an image: take a screenshot (⌘⇧4 on Mac, Win+Shift+S on Windows), or right-click an image in another app and pick Copy.
  2. Open the entry you want to paste into (or create a new one).
  3. Click into the body — the markdown area at the bottom of the page.
  4. Press ⌘V on Mac, or Ctrl+V on Windows / Linux.

The image appears immediately, sized to its natural width.

What you'll see

The image renders inline in the body the moment you paste. A small Uploading… caption sits under it while the bytes upload to your account. Once that caption disappears, the image is safely synced and will appear on every other device you sign in to.

You can keep typing around the image right away — there's no need to wait for the upload. The body autosaves like always.

Supported formats

For v1, Kaizendex accepts:

  • PNG (most macOS / iOS screenshots)
  • JPEG (most phone photos)
  • WebP
  • GIF (static or animated)

Pasting a non-image (a long screenshot of text, for example, or a PDF) falls through to normal text paste — Kaizendex won't try to upload it as an image.

Size limit

Each image can be up to 10 MiB. A typical screenshot is well under 1 MiB; a phone photo is usually 1-3 MiB. If you try to paste something bigger, a toast tells you so and nothing happens.

Across all your images combined, your account has a 500 MB allowance. You'll see a warning if a paste would push you over.

What happens offline

Pasting works offline. The image is stored on your device first, before any network call:

  • Paste while disconnected → the image appears as usual, with Uploading… underneath.
  • Reconnect → Kaizendex automatically tries to upload again, every few seconds at first, then with longer gaps. After about 40 minutes of trying, it gives up until you reload the page.
  • The bytes never leave your device until the upload succeeds, so they're safe in the meantime.

You can close the tab, switch devices, even fully power down — the image stays where it was pasted, and the upload resumes the next time you open Kaizendex on that device.

Removing an image

Click on the image in the body and press Backspace or Delete. The image disappears from the body and the file gets cleaned up automatically:

  • If no other Entry references the same image, it's deleted from your account and from every device (freeing up its share of your 500 MB allowance).
  • If you accidentally delete it, undo with ⌘Z (Mac) / Ctrl+Z (Windows / Linux) — the image comes right back from the same source. Anything you reverse within a few seconds is safe.

What happens if I delete the Entry?

  • Move to Trash (the standard Delete) → the image stays. The Entry can come back, so its images come back with it. Your storage allowance still counts these images.
  • Delete forever from Trash → the images attached only to that Entry are permanently removed from storage on every device.

So Trash is safe — nothing is destroyed until you explicitly empty it.

Where the image actually lives

Two places, kept in sync:

  • On your device — for instant rendering. This is why the image appears the moment you paste, even before any network call.
  • On the server — for cross-device sync. Open the same Entry on your phone, and the image fetches in the background and stays cached locally there too.

The body markdown only stores a stable id pointing to the image — not the bytes themselves. That makes the markdown small, portable, and stable: every device that has the Entry's body markdown can find the matching image.

Next