Plugins New in v0.2.13 #

Plugins are custom code that Eleventy can import into a project from an external repository.

List of Official Plugins #

All official plugins live under the @11ty npm organization and plugin names will include the @11ty/ prefix.

• @11ty/eleventy-plugin-rss is a collection of Nunjucks filters for RSS/Atom feed templates.
• @11ty/eleventy-plugin-syntaxhighlight for syntax highlighting using Markdown and Liquid tags.
• @11ty/eleventy-plugin-inclusive-language includes a simple linter to help your writing use more inclusive language. Inspired by CSS Tricks’ Words to Avoid in Educational Writing.

Unofficial Plugins #

• eleventy-plugin-toc by James Steinbach will generate a table of contents from your headings.
• eleventy-plugin-nesting-toc by Jordan Shurmer will generate a nested table of contents from your site's headings.
• @mightyplow/eleventy-plugin-cache-buster by mightyplow will add content hashes to JavaScript and CSS resources.
• eleventy-filter-npm-package-downloads by André Jaenisch will show you the number of downloads for the given npm package.
• eleventy-plugin-meta-generator by André Jaenisch will render a generator <meta /> tag for you.
• eleventy-plugin-pwa by Nanda Okitavera will generate a Service Worker for you.
• eleventy-plugin-reading-time by Johan Brook will generate a tag for the estimated reading time.
• eleventy-plugin-respimg by Eric Portis will take core of srcset attribute for responsive images for you.
• eleventy-plugin-typeset by Johan Brook will make your typography nicer.
• eleventy-plugin-yamldata by Sungkwang Lee will allow you to use a yaml file as local data file.
• @shawnsandy/npm_info by Shawn Sandy will provide you with package detail for an npm package or GitHub info.
• Search for eleventy-plugin on npm

Adding a Plugin #

Install the plugin through npm. #

npm install @11ty/eleventy-plugin-rss --save

Add the plugin to Eleventy in your config file #

Your config file is probably named .eleventy.js.

const pluginRss = require("@11ty/eleventy-plugin-rss");
module.exports = function(eleventyConfig) {
  eleventyConfig.addPlugin(pluginRss);
};

Plugin Configuration Options New in v0.5.4 #

Use an optional second argument to addPlugin to customize your plugin’s behavior. These options are specific to the plugin. Please consult the plugin’s documentation (e.g. the eleventy-plugin-syntaxhighlight README) to learn what options are available to you.

const pluginSyntaxHighlight = require("@11ty/eleventy-plugin-syntaxhighlight");
module.exports = function(eleventyConfig) {
  eleventyConfig.addPlugin(pluginSyntaxHighlight, {

    // only install the markdown highlighter
    templateFormats: ["md"],

    init: function({ Prism }) {
        // Add your own custom language to Prism!
    }
  });
};

Namespace the plugin additions #

You can namespace parts of your configuration using eleventyConfig.namespace. This will add a string prefix to all filters, tags, helpers, shortcodes (as of 0.7.0), collections, and transforms.

const pluginRss = require("@11ty/eleventy-plugin-rss");
module.exports = function(eleventyConfig) {
  eleventyConfig.namespace("myPrefix_", () => {
    // the rssLastUpdatedDate filter is now myPrefix_rssLastUpdatedDate
    eleventyConfig.addPlugin(pluginRss);
  });
};