diff --git a/examples/custom-elements/.eleventy.js b/examples/custom-elements/.eleventy.js
new file mode 100644
index 0000000..31084f0
--- /dev/null
+++ b/examples/custom-elements/.eleventy.js
@@ -0,0 +1,82 @@
+const transformDomPlugin = require('eleventy-plugin-transformdom');
+
+
+
+// generate transformers for transformDomPlugin
+function getElementTransformer(selector, options = {}) {
+
+  const defaultOptions = {
+    name: 'div',
+    attributes: (e => Object.fromEntries(Array.from(e.attributes).map(a => [a.name, a.value]))),
+    class: (e => e.localName), // lowercase tag name
+  };
+  options = Object.assign(defaultOptions, options);
+
+  const getName = (
+    (typeof options.name == 'function') ? (e => options.name(e)) :
+    (() => options.name)
+  );
+
+  const getAttributes = (
+    (typeof options.attributes == 'function') ? (e => options.attributes(e)) :
+    (typeof options.attributes == 'object') ? (() => options.attributes) :
+    (() => false)
+  );
+
+  const getExtraClass = (
+    (typeof options.class == 'function') ? (e => options.class(e)) :
+    (typeof options.class == 'string') ? (() => options.class) :
+    (() => false)
+  );
+
+  const domTransformer = {
+    selector,
+    transform: ({ elements, document }) => {
+      for (const element of elements) {
+        const nameNew = getName(element);
+        if (!nameNew) continue; // no replace
+        const attributesNew = getAttributes(element) || {};
+        const extraClassNew = getExtraClass(element);
+
+        const elementNew = document.createElement(nameNew);
+
+        // copy attributes
+        for (const [name, value] of Object.entries(attributesNew)) {
+          elementNew.setAttribute(name, value);
+        }
+
+        // copy content
+        elementNew.innerHTML = element.innerHTML;
+
+        // add class
+        if (extraClassNew) elementNew.classList.add(extraClassNew);
+
+        element.replaceWith(elementNew);
+      }
+    },
+  };
+  return domTransformer;
+}
+
+
+
+module.exports = function (eleventyConfig) {
+  const domTransformers = [];
+
+  // in:  <page>hello</page>
+  // out: <div class="page-element">hello</div>
+  domTransformers.push(getElementTransformer('page', { class: 'page-element' }));
+
+  // in:  <nw>dont wrap me</nw>
+  // out: <span class="nowrap-element">dont wrap me</span>
+  domTransformers.push(getElementTransformer('nw', { name: 'span', class: 'nowrap-element' }));
+
+  // in:  <en>good day</en><de>guten tag</de>
+  // out: <span lang="en">good day</span><span lang="de">guten tag</span>
+  for (const langKey of ['en', 'de']) {
+    domTransformers.push(getElementTransformer(langKey,
+      { name: 'span', attributes: (e => ({ lang: e.localName })), class: false }));
+  }
+
+  eleventyConfig.addPlugin(transformDomPlugin, domTransformers);
+};
diff --git a/examples/custom-elements/index.md b/examples/custom-elements/index.md
new file mode 100644
index 0000000..e47a595
--- /dev/null
+++ b/examples/custom-elements/index.md
@@ -0,0 +1,27 @@
+# Custom elements demo
+
+This is a demo of
+[eleventy-plugin-transformdom](https://github.com/liamfiddler/eleventy-plugin-transformdom)
+which transforms custom elements.
+
+result:
+
+<page>
+  <nw>dont wrap me</nw>
+  <p>
+    <en>good day</en>
+    <de>guten tag</de>
+  </p>
+</page>
+
+expected source:
+
+<textarea disabled cols="52" rows="8">
+<div class="page-element">
+  <span class="nowrap-element">dont wrap me</span>
+  <p>
+    <span lang="en">good day</span>
+    <span lang="de">guten tag</span>
+  </p>
+</div>
+</textarea>
diff --git a/examples/custom-elements/package.json b/examples/custom-elements/package.json
new file mode 100644
index 0000000..579ad39
--- /dev/null
+++ b/examples/custom-elements/package.json
@@ -0,0 +1,15 @@
+{
+  "name": "eleventy-plugin-transformdom-examples-custom-elements",
+  "version": "1.0.0",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "start": "eleventy --serve",
+    "build": "eleventy"
+  },
+  "author": "@liamfiddler",
+  "license": "MIT",
+  "devDependencies": {
+    "@11ty/eleventy": "^0.11.0",
+    "eleventy-plugin-transformdom": "../../"
+  }
+}