diff --git a/docs/css/style.css b/docs/css/style.css
index e4e96fdaa..8e85b4733 100644
--- a/docs/css/style.css
+++ b/docs/css/style.css
@@ -684,6 +684,13 @@ details.sidebar-section[open] > summary.sidebar-heading::after {
   line-height: 1.6;
 }
 
+/* Constrain in-article images to the content column so large assets
+ * (e.g. the 2000px demo GIF) never overflow the layout. */
+.content img {
+  max-width: 100%;
+  height: auto;
+}
+
 /* Inline code */
 .content code {
   font-family: var(--font-mono);
diff --git a/docs/demo.gif b/docs/demo.gif
index e235a4f3e..03d4bfc0e 100644
Binary files a/docs/demo.gif and b/docs/demo.gif differ