diff --git a/website/public/blog/accordion/accordion-enclosed.png b/website/public/blog/accordion/accordion-enclosed.png
new file mode 100644
index 0000000000..e4209173fc
Binary files /dev/null and b/website/public/blog/accordion/accordion-enclosed.png differ
diff --git a/website/public/blog/accordion/accordion-outline.png b/website/public/blog/accordion/accordion-outline.png
new file mode 100644
index 0000000000..2831a92b96
Binary files /dev/null and b/website/public/blog/accordion/accordion-outline.png differ
diff --git a/website/public/blog/accordion/accordion-sizes.png b/website/public/blog/accordion/accordion-sizes.png
new file mode 100644
index 0000000000..a9c6fafbd6
Binary files /dev/null and b/website/public/blog/accordion/accordion-sizes.png differ
diff --git a/website/public/blog/accordion/accordion-subtle.png b/website/public/blog/accordion/accordion-subtle.png
new file mode 100644
index 0000000000..93fc3d9ecb
Binary files /dev/null and b/website/public/blog/accordion/accordion-subtle.png differ
diff --git a/website/public/blog/accordion/accordion-variants.png b/website/public/blog/accordion/accordion-variants.png
new file mode 100644
index 0000000000..ba9459f044
Binary files /dev/null and b/website/public/blog/accordion/accordion-variants.png differ
diff --git a/website/src/content/blog/design-system-accordion.mdx b/website/src/content/blog/design-system-accordion.mdx
index ab9c5e507c..a2efac2a20 100644
--- a/website/src/content/blog/design-system-accordion.mdx
+++ b/website/src/content/blog/design-system-accordion.mdx
@@ -305,8 +305,11 @@ accordion variants: `outline`, `subtle`, and `enclosed`.
#### Outline
-The `outline` variant adds a clean separator between items using a bottom border. This works well for minimalist
-interfaces. In your `accordion.css` stylesheet, add the following styles:
+The `outline` variant adds a clean separator between items using a bottom border.
+
+
+
+This works well for minimalist interfaces. In your `accordion.css` stylesheet, add the following styles:
```css
.accordion--variant-outline [data-scope='accordion'][data-part='item'] {
@@ -318,6 +321,8 @@ interfaces. In your `accordion.css` stylesheet, add the following styles:
The `subtle` variant uses a soft background and padding to distinguish accordion items.
+
+
```css
.accordion--variant-subtle {
[data-scope='accordion'][data-part='item-trigger'],
@@ -339,6 +344,8 @@ The `subtle` variant uses a soft background and padding to distinguish accordion
The `enclosed` variant visually groups all accordion items inside a bordered box, giving card-like structure.
+
+
```css
.accordion--variant-enclosed [data-scope='accordion'][data-part='root'] {
border: 1px solid #e2e8f0;
@@ -370,6 +377,8 @@ The `enclosed` variant visually groups all accordion items inside a bordered box
To make your Accordion responsive to different layouts, we’ll add small, medium and large variants using the `sm`, `md`,
and `lg` classes.
+
+
Each size sets its own padding, border radius, and font size using CSS variables:
```css
@@ -827,6 +836,8 @@ maintain consistent spacing between the trigger and content body.
A flexible design system supports different visual variants to fit design needs. We’ll support the `outline`, `subtle`,
and `enclosed` visual variants to align with different UI patterns.
+
+
Within the `variants` key of your recipe, define the visual variants:
```tsx
@@ -892,6 +903,8 @@ variants: {
We also support `sm`, `md`, and `lg` size variants. These define CSS variables that affect padding, border radius, and
font size.
+
+
Within the `size` key of your recipe, define the size variants:
```tsx