diff --git a/README.md b/README.md
index b2543c9..8ae13d3 100644
--- a/README.md
+++ b/README.md
@@ -152,6 +152,21 @@ If you need finer control, [decorate](https://github.com/rstacruz/markdown-it-de
 
 Remember to [render attributes](https://github.com/arve0/markdown-it-attrs/blob/a75102ad571110659ce9545d184aa5658d2b4a06/index.js#L100) if you use a custom renderer.
 
+## Custom Delimiter
+
+You can configure `markdown-it-attrs` to use a different delimeter to declare attributes.
+
+```javascript
+md().use(attrs, {
+  leftDelimiter: '[',
+  rightDelimiter: ']'
+});
+```
+
+```markdown
+# Title [.large]
+```
+
 ## License
 
 MIT © [Arve Seljebu](http://arve0.github.io/)