diff --git a/web/routes/uix/components/words/+page.svelte b/web/routes/uix/components/words/+page.svelte
index c120e95f3..ea7133b90 100644
--- a/web/routes/uix/components/words/+page.svelte
+++ b/web/routes/uix/components/words/+page.svelte
@@ -536,6 +536,12 @@
 					language: 'ts',
 					children: [{ type: 'text', text: "const words = createWordsState('ActiveUIX');" }]
 				},
+				{
+					type: 'image',
+					src: 'https://placecats.com/600/300',
+					alt: 'Demo cat placeholder showing the image block in action',
+					caption: 'Image blocks are first-class: alt, optional caption, optional alignment.'
+				},
 				{
 					type: 'table',
 					striped: true,
@@ -738,6 +744,10 @@
 						)
 						.join('\n');
 				}
+				if (block.type === 'image') {
+					// Image has no inline children — represent in plain text via alt.
+					return block.alt ?? '';
+				}
 				return block.children.map(readInlineText).join('');
 			})
 			.join('\n');