diff --git a/docs/scripts/notebook_convert.py b/docs/scripts/notebook_convert.py
index 03f98bd7a60..c606c98e037 100644
--- a/docs/scripts/notebook_convert.py
+++ b/docs/scripts/notebook_convert.py
@@ -25,6 +25,10 @@ class EscapePreprocessor(Preprocessor):
                     cell.source,
                     flags=re.DOTALL,
                 )
+            # rewrite .ipynb links to .md
+            cell.source = re.sub(
+                r"\[([^\]]*)\]\(([^)]*).ipynb\)", r"[\1](\2.md)", cell.source
+            )
         return cell, resources