Skip to content

Images & Media

Each note in Tessera can have associated images. Images are stored in a subfolder named after the note, keeping your filesystem clean and portable.

Adding images

There are two ways to attach an image to a note:

Paste from clipboard

While editing a note, paste an image from your clipboard (Cmd+V / Ctrl+V). The image is uploaded and its Markdown reference is automatically inserted at your cursor position.

Click an image thumbnail in the gallery to open the lightbox preview, then use the Insert to Markdown button to inject the image reference into your note's editor.

Every card has a scrollable gallery strip at the bottom showing thumbnails of all attached images.

  • Click a thumbnail to open the full-size lightbox preview.
  • Delete an image by hovering over the thumbnail and clicking the red × button.

The lightbox shows a large preview of the selected image with two actions:

  • Close — dismiss the preview.
  • Insert to Markdown — insert ![filename](note_id/filename) at the current cursor position in the editor.

Copying an image

Right-click any image (in the gallery, lightbox, or rendered preview) to get the Copy Image option. This copies the image to your system clipboard.

Images in Markdown preview

When your note content includes Markdown image syntax like:

![photo.png](my_note/photo.png)

The image is rendered inline in the preview. Images are automatically resolved to the correct path.

File storage

Images are saved to disk inside a subfolder matching the note's ID:

your-project/
├── my_note.md
└── my_note/
    ├── photo.png
    └── diagram.jpg

This structure is Git-friendly and portable — you can browse, copy, or back up your images with any file manager.