From 240ecf03b8c16021a609397a056d6ff342a6e3bc Mon Sep 17 00:00:00 2001
From: brian <brian@lorf.org>
Date: Thu, 28 May 2020 13:04:19 +0700
Subject: [PATCH] Add example to docs of custom element (#186)

* Add example to docs of custom element

* incorporate feedback
---
 docs/content/basic-syntax.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/content/basic-syntax.md b/docs/content/basic-syntax.md
index 745fc29..48b86e5 100644
--- a/docs/content/basic-syntax.md
+++ b/docs/content/basic-syntax.md
@@ -79,6 +79,20 @@ Before version 0.18, Maud allowed the curly braces to be omitted. This syntax wa
 
 [#137]: https://github.com/lambda-fairy/maud/pull/137
 
+## Non-standard HTML ("custom") elements
+
+Maud is not restricted to writing well-known HTML elements like `h1`, `p`, `span`, etc. If you want to use [custom elements][custom-elements], you can.
+
+```rust
+html! {
+    blog-post {
+        title { "My blog" }
+    }
+}
+```
+
+[custom-elements]: https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements
+
 ## Non-empty attributes `id="yay"`
 
 ```rust