Kaizendex HelpOpen the app

Images in the body

Paste, drag, or upload an image straight into an Entry's note — it appears instantly, syncs in the background, and works offline.

You can add images to the body of any Entry three ways: paste from your clipboard, drag-and-drop a file in, or use the /Image command. The image shows up the moment you add it — 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.

Three ways to add an image

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 (or create a new one) and click into its note.
  3. Press ⌘V on Mac, or Ctrl+V on Windows / Linux.

Drag-and-drop — drag an image file from your desktop or another window and drop it into the note.

/Image — type / in the note, choose Image, and pick a file. On your phone, tap the Image button in the toolbar above the keyboard.

The image appears immediately, sized to its natural width.

What you'll see

The image renders inline the moment you add it, and syncs to your account in the background — you can keep typing around it right away, no need to wait. The note autosaves like always.

Resizing and moving an image

Click an image and small handles appear on its left and right edges — drag either one to resize it (the proportions stay locked). To move an image, hover it and grab the ⋮⋮ handle in the left margin, then drag it anywhere in the note, just like any other block. The size and position are saved with the note and sync everywhere.

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 note only stores a stable id pointing to the image — not the bytes themselves. That makes it small, portable, and stable: every device that has the Entry can find the matching image.

Find every image you've added

Open Files & Photos in the sidebar to see all your images in one place — with a thumbnail, type, size, date, and a link back to the entry each one is used in. See Files & Photos.

Next