diff --git a/components/frames.mdx b/components/frames.mdx
index 03d3d08cb..5934c8b09 100644
--- a/components/frames.mdx
+++ b/components/frames.mdx
@@ -18,6 +18,18 @@ Add additional context to an image using the optional `caption` prop. Captions a
   <img src="https://mintlify-assets.b-cdn.net/yosemite.jpg" alt="Photograph of Yosemite Valley." />
 </Frame>
 
+### Markdown in captions
+
+Captions support markdown formatting, including links and bold text.
+
+<Frame caption="Learn more about [Yosemite National Park](https://www.nps.gov/yose/index.htm) and plan your visit.">
+  <img src="https://mintlify-assets.b-cdn.net/yosemite.jpg" alt="Photograph of Yosemite Valley." />
+</Frame>
+
+<Frame caption="**Important:** Check the [park website](https://www.nps.gov/yose/index.htm) for current conditions.">
+  <img src="https://mintlify-assets.b-cdn.net/yellowstone.jpeg" alt="Photograph of a lake surrounded by trees with mountains in the distance in Yellowstone National Park." />
+</Frame>
+
 ## Hints
 
 Add text that precedes the frame using the optional `hint` prop. Hints appear above the frame.
@@ -29,7 +41,7 @@ Add text that precedes the frame using the optional `hint` prop. Hints appear ab
 ## Properties
 
 <ResponseField name="caption" type="string">
-  Text that appears as part of the frame, centered below the content.
+  Text that appears as part of the frame, centered below the content. Supports markdown formatting including links and bold text.
 </ResponseField>
 
 <ResponseField name="hint" type="string">
@@ -50,6 +62,18 @@ Add text that precedes the frame using the optional `hint` prop. Hints appear ab
 </Frame>
 ```
 
+```mdx Frame with markdown in caption
+<Frame caption="Visit the [documentation](/docs) for more details">
+  <img src="/path/image.jpg" alt="Descriptive alt text" />
+</Frame>
+```
+
+```mdx Frame with bold text and links in caption
+<Frame caption="**Note:** See the [official guide](https://example.com) for setup instructions">
+  <img src="/path/image.jpg" alt="Descriptive alt text" />
+</Frame>
+```
+
 ```mdx Frame with a hint
 <Frame hint="Hint text">
   <img src="/path/image.jpg" alt="Descriptive alt text" />