Image Workflow

viewMarkdown Icon

viewMarkdown lets you keep an image where it already lives, copy it into a local folder structure, or upload it through a configured service. This page helps you choose the right default for your documents.

Core questionGlobal or relative image folder?
OutcomePredictable file layout that eases export and sharing.

Default Insert Modes

Upload Upload the image through the selected internet uploader after configuration.
Folder Copy the image to the designated relative assets folder or global local folder.
Path Keep the original file location and link to it directly.

Recommended Use

For shareable projects Prefer a relative assets folder so the Markdown file and its images travel together.
For a central media library Use a global folder when many documents intentionally reuse the same images.
For one-off references Keep the original path only when the source image location is stable.

Relative Assets

The image preferences allow you to prefer a relative assets folder and to set the relative folder name. The default is assets, and the setting also supports ${filename} so each document can get its own predictable subfolder. 

Meeting Notes.md
Meeting Notes.assets
Meeting Notes.assets\diagram-01.png

Windows File Layout

A relative folder keeps exports, repository moves, and handoffs simpler. It also reduces the chance that a document depends on a machine-specific absolute path.

The image settings pane includes both an "Open..." path picker and "Show in Folder". They help to verify where the copied asset actually landed.

When you do use a global folder, make sure the directory is backed up and remains available to every machine that edits the document set.

Remote Images and Internet Controls

Internet-facing image behavior is managed centrally in the preferences. That keeps upload services, size limits, and legal notices in one place.

Practical Rule

If the Markdown file is expected to move, sync, or be reviewed outside one machine, start with a relative assets folder. It is the safest default.