diff --git a/.gitpod.yml b/.gitpod.yml
index 817eeeb6a..203e5c7d9 100644
--- a/.gitpod.yml
+++ b/.gitpod.yml
@@ -1,5 +1,6 @@
 vscode:
   extensions:
+    - bpruitt-goddard.mermaid-markdown-syntax-highlighting
     - editorconfig.editorconfig
     - esbenp.prettier-vscode
     - ms-python.python
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
index e3f98f806..c1746b7b8 100644
--- a/.vscode/extensions.json
+++ b/.vscode/extensions.json
@@ -2,6 +2,7 @@
   "recommendations": [
     "esbenp.prettier-vscode",
     "ms-python.python",
-    "editorconfig.editorconfig"
+    "editorconfig.editorconfig",
+    "bpruitt-goddard.mermaid-markdown-syntax-highlighting"
   ]
 }