Images and tables

Insert and store images, adjust their displayed size, and edit table rows and columns.

Insert an image

  1. Save the document first with Ctrl+S.
  2. Drop an image file onto the editor in source mode, or paste an image from the clipboard with Ctrl+V.
  3. Check that the image appears in the preview, then save the document.

When you insert an image into a saved sample.md, the image is copied into a sample folder beside it and a relative link is written into the text. An image whose name is already taken is numbered, so existing images are never overwritten.

Images pasted into an unsaved document are stored temporarily. Images older than seven days are removed; if there are more than 100 temporary images, the oldest are also removed. Save your document before inserting images you want to keep.

When the clipboard holds both an image and text, the text takes precedence. Ctrl+Shift+I does not paste the image itself: it inserts an ![alt](url) template.

Bring an image from the web into the document

Right-click an image in the preview and choose Save Image Locally. The image is saved and the URL in the text is rewritten. The document has to be saved first.

To do this automatically, turn on Settings → Images → Auto-save Images. Images are saved into a .<document name> folder beside the document. If a <document name> folder created by drag and drop already exists, that folder is used instead.

Automatic image saving does not run when Settings → Network → External Resource Fetching is set to Do not fetch (link text only).

Adjust the size and position of an image

Click an image in the preview to show its selection frame.

OperationResult
Drag the handle at the bottom rightChanges the displayed width
Drag inside the frame, left or rightChanges the horizontal position
Drag left or right with Shift heldSnaps to left, centre or right
Drag inside the frame, up or downMoves the image to another line in the text
The magnifier at the top rightShows the image enlarged. Click or press Esc to close it

The width and the horizontal position are stored in <image file name>.settings.json beside the image. This adjustment does not rewrite the Markdown text, and it applies to other documents that reference the same image.

If you replace the image file and the old one is still shown, press F5 to refresh.

Create and edit tables

Alt+Shift+T, or the formatting toolbar, inserts a table template.

| Task | Owner | Status |
| ---------------- | ------ | -------- |
| Review the draft | Editor | [ ] Open |

Placing the cursor inside a table in the source shows its editing handles. Drag the handle to the left of a row up or down, and the handle above a column left or right, to reorder them. The handle at the bottom right adds rows and columns, and removes empty ones at the end.

Right-click inside the table and open the Table submenu to add or remove rows and columns, change column alignment, or sort rows by the current column. Alt+Shift+F formats the whole document, including table column widths.

Share a document that contains images

Keep the Markdown file and its attachment folder together when you store or move them. Dropping a video does not copy the file: it links to the original location, so moving the video breaks the link.

To distribute a single file, use PDF export and check the result. HTML output does not embed local images.

Shortcuts are listed with their default assignments. If you have changed them, check the current keys in the in-app help (F12).