diff --git a/README.md b/README.md
index e1a6c3fa8..87fad43a6 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,33 @@
 # Courses
 
-A flat-file database of courses in multiple languages.
\ No newline at end of file
+A flat-file database of courses in multiple languages.
+
+
+### Mermaid demo
+
+You can use graphs in the courses :
+
+
+    ```mermaid
+    graph LR
+    subgraph Course
+        File[File]
+    end
+
+    Student((Student))
+
+    Student --> |reads| File
+    ```
+
+yields
+
+```mermaid
+graph LR
+  subgraph Course
+    File[File]
+  end
+
+  Student((Student))
+
+  Student --> |reads| File
+```
\ No newline at end of file