diff --git a/README.md b/README.md
index 31d65fe..dc2b93b 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,8 @@
 
 An HTML entity encoder/decoder for Gleam.
 
+Entities can be encoded using named or hex entity references. Named entity references use the WHATWG "Named character references" list available at https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references.
+
 ## Quick start
 
 ```gleam