Skip to content

Get started

Installation

bash
pnpm add -D vitepress-plugin-image-optimize

Usage

js
// .vitepress/config.ts

import {optimizeImages} from "vitepress-plugin-image-optimize";

// https://vitepress.dev/reference/site-config
export default defineConfig({
  // ..... your existing VitePress config

  markdown: {
    config: (md) => {
      md.use(
        optimizeImages({
          srcDir: "docs", // Default: "docs"
          quality: 90, // Default: 90
          lazyLoading: true, // Default: false
        })
      )
    }
  }
})

To mark an image as 2x, add @2x to its name. For example, my-image@2x.png.

The plugin will make a smaller version of the image and show it on devices with a smaller screen resolution.