diff --git a/docs/index.md b/docs/index.md
index 6042210c..f2391312 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -190,8 +190,8 @@ mittask.rst
 measurement_reduction.rst
 spam.rst
 frame_randomisation.rst
-postselection.rst
-leakage_detection.rst
+postselection.md
+leakage_detection.md
 coherent_pauli_checks.rst
 clifford_noise_characterisation.rst
 zero_noise_extrapolation.rst
diff --git a/docs/leakage_detection.rst b/docs/leakage_detection.md
similarity index 55%
rename from docs/leakage_detection.rst
rename to docs/leakage_detection.md
index f890175f..dc4cc651 100644
--- a/docs/leakage_detection.rst
+++ b/docs/leakage_detection.md
@@ -1,5 +1,9 @@
-qermit.leakage_detection
-========================
+---
+file_format: mystnb
+---
 
-.. autofunction:: qermit.leakage_detection.leakage_detection.get_leakage_detection_mitres
+# qermit.leakage_detection
 
+```{eval-rst}
+.. autofunction:: qermit.leakage_detection.leakage_detection.get_leakage_detection_mitres
+```
diff --git a/docs/postselection.rst b/docs/postselection.md
similarity index 70%
rename from docs/postselection.rst
rename to docs/postselection.md
index cd498c87..d8ba6081 100644
--- a/docs/postselection.rst
+++ b/docs/postselection.md
@@ -1,7 +1,12 @@
-qermit.postselection
-====================
+---
+file_format: myst
+---
 
+# qermit.postselection
+
+```{eval-rst}
 .. autoclass:: qermit.postselection.postselect_manager.PostselectMgr
     :members:
 
 .. autofunction:: qermit.postselection.postselect_mitres.gen_postselect_mitres
+```