diff --git a/README.md b/README.md
index eae2129..a45fb22 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,16 @@ Being form associated also means that you can send data to your own servers with
```
+Stones can be decorated with markers. The `go-stone-marker` element can be passed as a child to `go-stone` and you can add any icon or html entity that you like.
+
+```html
+