2.2.0 • Public • Published


Build Status GitHub stars license

eleventy-plugin-images-responsiver is a simple solution for most responsive images needs with Eleventy.

This Eleventy plugin allows authors to use the standard Markdown syntax for images (![alt text](image.jpg "title text")) and yet get responsive images in the generated HTML, with srcset and sizes attributes.

Why does this project exist?

As Steve Jobs once said:

You've got to start with the customer experience and run backwards to the technology.

Responsive images are one of the most difficult topics nowadays for front end developers and content authors, they involve multiple features and syntaxes, but they are required to provide a good performance to Web users.

Most content authors should not have to learn the complex responsive images HTML syntax, and how it is used by browsers to load the right image for current viewing context.

Knowing that <picture> is only required for rare advanced usages, eleventy-plugin-images-responsiver should be enough for most use cases, known as Resolution Switching. Read this article on Cloudfour's blog to know more of the theory.

How does it work?

eleventy-plugin-images-responsiver is the glue between Eleventy plugin and transformations system and images-responsiver, the generic HTML transformation npm package for simple responsive images.

Eleventy uses Markdown-it to transform Markdown content into HTML, and then runs the transform added by eleventy-plugin-images-responsiver, which calls images-responsiver to actually transform the HTML.

Warning This plugin doesn't generate any image, it has to be used either with already existing images, a local image resizing solution (should work with the official eleventy-img plugin), or a third party service ("image CDN") like Cloudinary.

Learn more in the detailed documentation.


To install and use the plugin, install it as a dev dependency in your Eleventy project:

npm install eleventy-plugin-images-responsiver --save-dev


Instead of jumping directly into the list of features and configuration options, let us take your hand and guide you through a step by step tutorial with actual examples.

Let's start here!

If you already know how to use the plugin and want to go directly to a section of the tutorial, here are direct links:


To deal with responsive images in Eleventy, there are multiple other plugins:


First, thank you for considering contributing to eleventy-plugin-images-responsiver! It's people like you that make the open source community such a great community! 😊

There are many ways to contribute to this project. Get started here.


This project is licensed under the MIT License.


See also the list of contributors who participated in this project.

Package Sidebar


npm i eleventy-plugin-images-responsiver

Weekly Downloads






Unpacked Size

9.08 kB

Total Files


Last publish


  • nhoizey