diff --git a/examples/index.md b/examples/index.md
index a3952f3..44b745b 100644
--- a/examples/index.md
+++ b/examples/index.md
@@ -2,28 +2,30 @@
 
 Examples from real datasets you'd actually analyse.
 
+<!-- gallery-cards-start -->
 ::::{grid} 1 2 2 2
 :gutter: 3
 
 :::{grid-item-card} Visium mouse brain
-:link: visium_mouse_brain
+:link: /notebooks/examples/visium_mouse_brain
 :link-type: doc
-:img-top: ../_static/img/visium_mouse_brain.png
+:img-top: /notebooks/_static/img/visium_mouse_brain.png
 
 Render H&E tissue, overlay spots, color by gene expression and by cluster,
 and finish with a publication-style figure.
 :::
 
 :::{grid-item-card} Interactive region annotation
-:link: interactive_annotate
+:link: /notebooks/examples/interactive_annotate
 :link-type: doc
-:img-top: ../_static/img/interactive_annotate.png
+:img-top: /notebooks/_static/img/interactive_annotate.png
 
 Draw regions of interest directly on a `spatialdata-plot` canvas with
 `sdata.pl.annotate(...)` and persist them as a `ShapesModel` element.
 :::
 
 ::::
+<!-- gallery-cards-end -->
 
 ```{toctree}
 :hidden:
diff --git a/tutorials/index.md b/tutorials/index.md
index a31d3d3..a5553d8 100644
--- a/tutorials/index.md
+++ b/tutorials/index.md
@@ -2,22 +2,23 @@
 
 Entry-point material for learning the API on synthetic data.
 
+<!-- gallery-cards-start -->
 ::::{grid} 1 2 2 2
 :gutter: 3
 
 :::{grid-item-card} Getting started
-:link: getting_started
+:link: /notebooks/tutorials/getting_started
 :link-type: doc
-:img-top: ../_static/img/getting_started.png
+:img-top: /notebooks/_static/img/getting_started.png
 
 The fluent `.pl` API, layering, and styling on the in-memory `blobs`
 dataset. Ideal first read.
 :::
 
 :::{grid-item-card} Colour and palettes
-:link: color_and_palette
+:link: /notebooks/tutorials/color_and_palette
 :link-type: doc
-:img-top: ../_static/img/color_and_palette.png
+:img-top: /notebooks/_static/img/color_and_palette.png
 
 How `color=` resolves, the v0.3.0 `groups` behaviour, and building
 perceptually well-spaced or colourblind-safe palettes with
@@ -25,9 +26,9 @@ perceptually well-spaced or colourblind-safe palettes with
 :::
 
 :::{grid-item-card} Speeding up rendering
-:link: performance
+:link: /notebooks/tutorials/performance
 :link-type: doc
-:img-top: ../_static/img/performance.png
+:img-top: /notebooks/_static/img/performance.png
 
 Keep rendering fast on large data: automatic rasterization and scale
 selection for images, and the `datashader` backend for large collections
@@ -35,6 +36,7 @@ of shapes and points.
 :::
 
 ::::
+<!-- gallery-cards-end -->
 
 ```{toctree}
 :hidden: