Images
The easiest way to add images is with the Draft42: Insert image command. Pick an image, set a caption and placement, and the plugin copies it to the right spot with a clean filename. The result is standard Markdown:
The alt text becomes the image caption on your site.
Placement
Most of the time, you don't need to worry about placement — the defaults look good. But when you want more control:
| Placement | Behavior |
|---|---|
wide | Extends beyond the text column on larger screens |
fit | Fills the text column width |
narrow | Narrower than the text column |
Landscape images default to fit and portrait images default to narrow.
Set placement in the title attribute:
To set both a title and placement, separate them with |||:
External Images
You can use external URLs instead of vault images:
We strongly recommend using vault images. External ones are rendered as-is with no processing — their dimensions are unknown, so they can break your layout, cause content to jump around as they load, and won't get placeholders or size optimization. They can also disappear if the source goes down.
Galleries
Want to show multiple images together? Use the Draft42: Insert gallery command — pick your images, add an optional caption, and the plugin handles the rest. It uses the [!GALLERY] callout syntax:
> [!GALLERY] Optional caption
> 
> 
> Each image can have its own caption (via alt text) and title.
Optimizations
Vault images are automatically optimized when published: they're served in multiple sizes for different viewports, lazy-loaded as you scroll, and displayed with state-of-the-art placeholders while loading.
Supported Formats
Allowed formats: JPG, PNG, WebP, GIF
Maximum file size: 10 MB