diff --git a/docs/entityRelationshipDiagram.md b/docs/entityRelationshipDiagram.md
new file mode 100644
index 000000000..cce0e5702
--- /dev/null
+++ b/docs/entityRelationshipDiagram.md
@@ -0,0 +1,21 @@
+# Entity Relationship Diagrams
+
+> An entity–relationship model (or ER model) describes interrelated things of interest in a specific domain of knowledge. A basic ER model is composed of entity types (which classify the things of interest) and specifies relationships that can exist between entities (instances of those entity types). Wikipedia.
+
+Mermaid can render ER diagrams
+```
+erDiagram
+    CUSTOMER !-?< ORDER : places
+    ORDER !-!< LINE-ITEM : contains
+```
+```mermaid
+erDiagram
+    CUSTOMER !-?< ORDER : places
+    ORDER !-!< LINE-ITEM : contains
+```
+
+## Syntax
+
+### Entities and Relationships
+
+To be completed