diff --git a/README.md b/README.md
index 87fad43a6..5f98e634a 100644
--- a/README.md
+++ b/README.md
@@ -2,13 +2,18 @@
 
 A flat-file database of courses in multiple languages.
 
+## Documentation
+
+- Read the extensive [Markdown documentation](https://docs.gitlab.com/ee/user/markdown.html).
+
+-----
 
 ### Mermaid demo
 
 You can use graphs in the courses :
 
 
-    ```mermaid
+    ``` mermaid
     graph LR
     subgraph Course
         File[File]
@@ -21,7 +26,7 @@ You can use graphs in the courses :
 
 yields
 
-```mermaid
+``` mermaid
 graph LR
   subgraph Course
     File[File]
@@ -30,4 +35,12 @@ graph LR
   Student((Student))
 
   Student --> |reads| File
-```
\ No newline at end of file
+```
+
+### Table demo
+
+| A | B |   | D |   |
+|---|---|---|---|---|
+|   |   |   |   |   |
+|   |   | X |   |   |
+|   |   | X |   | _test_  |
\ No newline at end of file