diff --git a/docs/flowchart.md b/docs/flowchart.md
index 97a162e5e..6e77fa710 100644
--- a/docs/flowchart.md
+++ b/docs/flowchart.md
@@ -497,6 +497,8 @@ It is possible to escape characters using the syntax exemplified here.
         A["A double quote:#quot;"] -->B["A dec char:#9829;"]
 ```
 
+Numbers given are base 10, so `#` can be encoded as `#35;`. It is also supported to use HTML character names.
+
 ## Subgraphs
 
 ```
diff --git a/docs/sequenceDiagram.md b/docs/sequenceDiagram.md
index 2fad53ca6..c1b15a9ce 100644
--- a/docs/sequenceDiagram.md
+++ b/docs/sequenceDiagram.md
@@ -347,6 +347,23 @@ sequenceDiagram
     John-->>Alice: Great!
 ```
 
+## Entity codes to escape characters
+
+It is possible to escape characters using the syntax exemplified here.
+
+```
+sequenceDiagram
+    A->>B: I #9829; you!
+    B->>A: I #9829; you #infin; times more!
+```
+```mermaid
+sequenceDiagram
+    A->>B: I #9829; you!
+    B->>A: I #9829; you #infin; times more!
+```
+
+Numbers given are base 10, so `#` can be encoded as `#35;`. It is also supported to use HTML character names.
+
 ## sequenceNumbers
 
 It is possible to get a sequence number attached to each arrow in a sequence diagram. This can be configured when adding mermaid to the website as shown below: