← Back to features
Media pipeline

Images that stay fast after they leave the editor

MarkNest prepares uploaded images for Markdown publishing by validating the input, converting it to WebP, and keeping shared documents light enough for public reading.

Start writing View API docs
large-capture.png
Editor upload
8.0 MB
WebP
Output
image.webp
Budget
1.5 MB
Delivery
R2 ready

Clear limits before storage

The pipeline treats images differently from general files. It protects processing time, storage, and public page weight before the asset becomes part of a document.

Accepted inputs
JPEG, PNG, WebP

Common formats only, with unsupported image types rejected before storage.

Published output
WebP

Every supported raster image is normalized to a browser friendly asset.

Default boundary
1600 px

Images fit inside the configured dimensions without cropping or distortion.

Delivery budget
1.5 MB

Large outputs are recompressed or resized until they fit the web budget.

Built for editor and share pages

Image URLs are durable after the document is saved. Refreshing the editor or opening a public share link should load the same optimized asset, not a temporary browser object URL.

  1. 01

    Validate original bytes, format, and pixel count before expensive processing.

  2. 02

    Resize proportionally inside the configured maximum width and height.

  3. 03

    Encode to WebP with adaptive quality and size reduction.

  4. 04

    Store the optimized asset on the configured disk, including Cloudflare R2.

  5. 05

    Use durable public URLs so editor refreshes and share links keep rendering images.