diff --git a/extras/environment.yml b/extras/environment.yml
index ebb7521b..59b5b109 100644
--- a/extras/environment.yml
+++ b/extras/environment.yml
@@ -5,6 +5,7 @@ channels:
 dependencies:
   # local development
   - black
+  - mdformat
   - nbqa
   - notebook
   - jupyter_contrib_nbextensions
diff --git a/extras/scripts/update.sh b/extras/scripts/update.sh
index a6d4a6ba..272cf84e 100755
--- a/extras/scripts/update.sh
+++ b/extras/scripts/update.sh
@@ -12,3 +12,5 @@ jupyter nbconvert \
   "$NOTEBOOK"
 
 nbqa black "$NOTEBOOK"
+# https://github.com/nbQA-dev/nbQA/issues/555#issuecomment-974651504
+nbqa mdformat "$NOTEBOOK" --nbqa-md