diff --git a/build/redisvl_docs_sync.py b/build/redisvl_docs_sync.py
index f527165c04..71d1f410c5 100644
--- a/build/redisvl_docs_sync.py
+++ b/build/redisvl_docs_sync.py
@@ -650,7 +650,7 @@ def transform_page(src: Path, staging: Path, moved_slugs: list[str]) -> None:
         text = moved_re.sub(r'relref "\1/how_to_guides/\2"', text)
         text = _rewrite_bare_relref_for_moved_layout(text, src, staging, moved_slugs)
     text = _IMAGE_STATIC.sub(
-        lambda m: f'{{{{< image filename="/images/redisvl/{m.group(2)}" alt="{m.group(1)}" >}}}}',
+        lambda m: f'![{m.group(1)}](/images/redisvl/{m.group(2)})',
         text,
     )
     # Upstream `user_guide/cli.ipynb` links to `../api/cli.rst`, but no such
diff --git a/content/develop/ai/redisvl/0.15.0/concepts/architecture.md b/content/develop/ai/redisvl/0.15.0/concepts/architecture.md
index 3645c0ca0c..aef07863a6 100644
--- a/content/develop/ai/redisvl/0.15.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.15.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.15.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.16.0/concepts/architecture.md b/content/develop/ai/redisvl/0.16.0/concepts/architecture.md
index ee4329f5e1..5f6f456a99 100644
--- a/content/develop/ai/redisvl/0.16.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.16.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.16.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.17.0/concepts/architecture.md b/content/develop/ai/redisvl/0.17.0/concepts/architecture.md
index de493eca5e..425386b41e 100644
--- a/content/develop/ai/redisvl/0.17.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.17.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.17.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.17.1/concepts/architecture.md b/content/develop/ai/redisvl/0.17.1/concepts/architecture.md
index b604174cdb..03a49406b1 100644
--- a/content/develop/ai/redisvl/0.17.1/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.17.1/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.17.1/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.18.0/concepts/architecture.md b/content/develop/ai/redisvl/0.18.0/concepts/architecture.md
index 5f746be490..b35ff787d5 100644
--- a/content/develop/ai/redisvl/0.18.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.18.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.18.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.18.1/concepts/architecture.md b/content/develop/ai/redisvl/0.18.1/concepts/architecture.md
index 334b772ec5..c9ff047fb8 100644
--- a/content/develop/ai/redisvl/0.18.1/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.18.1/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.18.1/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.18.2/concepts/architecture.md b/content/develop/ai/redisvl/0.18.2/concepts/architecture.md
index d924bcb512..8698b48876 100644
--- a/content/develop/ai/redisvl/0.18.2/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.18.2/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.18.2/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.19.0/concepts/architecture.md b/content/develop/ai/redisvl/0.19.0/concepts/architecture.md
index 64eb0f4a1b..2bc388f99b 100644
--- a/content/develop/ai/redisvl/0.19.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.19.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.19.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.20.0/concepts/architecture.md b/content/develop/ai/redisvl/0.20.0/concepts/architecture.md
index ec249245dc..4df418fb87 100644
--- a/content/develop/ai/redisvl/0.20.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.20.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.20.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.20.1/concepts/architecture.md b/content/develop/ai/redisvl/0.20.1/concepts/architecture.md
index 7a1ac2f1be..93e87407d9 100644
--- a/content/develop/ai/redisvl/0.20.1/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.20.1/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.20.1/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.22.0/concepts/architecture.md b/content/develop/ai/redisvl/0.22.0/concepts/architecture.md
index c96f82cbda..37998d939a 100644
--- a/content/develop/ai/redisvl/0.22.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.22.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.22.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.23.0/concepts/architecture.md b/content/develop/ai/redisvl/0.23.0/concepts/architecture.md
index 0fe419c3cf..aa3faad192 100644
--- a/content/develop/ai/redisvl/0.23.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.23.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.23.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.24.0/concepts/architecture.md b/content/develop/ai/redisvl/0.24.0/concepts/architecture.md
index 64d1bdb44c..09ce502103 100644
--- a/content/develop/ai/redisvl/0.24.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.24.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.24.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.25.0/concepts/architecture.md b/content/develop/ai/redisvl/0.25.0/concepts/architecture.md
index 739367be9a..0c141d1d35 100644
--- a/content/develop/ai/redisvl/0.25.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.25.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.25.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.25.1/concepts/architecture.md b/content/develop/ai/redisvl/0.25.1/concepts/architecture.md
index 3c2a709715..3b733e2528 100644
--- a/content/develop/ai/redisvl/0.25.1/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.25.1/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.25.1/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.26.0/concepts/architecture.md b/content/develop/ai/redisvl/0.26.0/concepts/architecture.md
index 8c2471d030..02a514f002 100644
--- a/content/develop/ai/redisvl/0.26.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.26.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.26.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.27.0/concepts/architecture.md b/content/develop/ai/redisvl/0.27.0/concepts/architecture.md
index 9424598a6c..ace9eaf553 100644
--- a/content/develop/ai/redisvl/0.27.0/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.27.0/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.27.0/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/0.27.1/concepts/architecture.md b/content/develop/ai/redisvl/0.27.1/concepts/architecture.md
index 3d1482aaa5..2d6525e6c6 100644
--- a/content/develop/ai/redisvl/0.27.1/concepts/architecture.md
+++ b/content/develop/ai/redisvl/0.27.1/concepts/architecture.md
@@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.27.1/concepts/architecture/'
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern
 
diff --git a/content/develop/ai/redisvl/concepts/architecture.md b/content/develop/ai/redisvl/concepts/architecture.md
index 44103764ca..16dbae74d2 100644
--- a/content/develop/ai/redisvl/concepts/architecture.md
+++ b/content/develop/ai/redisvl/concepts/architecture.md
@@ -8,7 +8,7 @@ aliases:
 
 RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes.
 
-{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}}
+![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg)
 
 ## The Core Pattern