diff --git a/fern/docs.yml b/fern/docs.yml
index c3c8cb78a..a8e5d62c5 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -303,6 +303,8 @@ redirects:
     destination: /learn/docs/writing-content/components/accordions
   - source: /learn/docs/writing-content/components/card-groups
     destination: /learn/docs/writing-content/components/cards
+  - source: /learn/docs/writing-content/components/embed
+    destination: /learn/docs/writing-content/components/download
   - source: /learn/docs/building-and-customizing-your-docs/navigation
     destination: /learn/docs/configuration/navigation
   - source: /learn/docs/navigation/overview
diff --git a/fern/products/docs/docs.yml b/fern/products/docs/docs.yml
index b0b49246b..cea1de77f 100644
--- a/fern/products/docs/docs.yml
+++ b/fern/products/docs/docs.yml
@@ -67,9 +67,9 @@ navigation:
             path: ./pages/component-library/default-components/code-blocks.mdx
             icon: fa-duotone fa-code
             slug: code-blocks
-          - page: Embed
-            path: ./pages/component-library/default-components/embed.mdx
-            icon: fa-duotone fa-window-restore
+          - page: Download
+            path: ./pages/component-library/default-components/download.mdx
+            icon: fa-duotone fa-download
           - page: Endpoint request snippet
             path: ./pages/component-library/default-components/endpoint-request-snippet.mdx
             icon: fa-duotone fa-arrow-up
diff --git a/fern/products/docs/pages/component-library/default-components/download.mdx b/fern/products/docs/pages/component-library/default-components/download.mdx
new file mode 100644
index 000000000..bbd76590b
--- /dev/null
+++ b/fern/products/docs/pages/component-library/default-components/download.mdx
@@ -0,0 +1,38 @@
+---
+title: "Download"
+description: "Download assets like PDFs directly from your documentation"
+---
+
+The `<Download>` component lets users download assets like PDFs directly from your documentation.
+
+<Info>
+For information on how to embed assets, check out the documentation on [Images](/learn/docs/writing-content/markdown#images), [PDFs](/learn/docs/writing-content/markdown#pdfs), and [Videos](/learn/docs/writing-content/markdown#videos).
+</Info>
+
+## Usage
+
+<div className="highlight-frame">
+<Download src="./all-about-ferns.pdf">
+  <Button intent="primary">Download PDF</Button>
+</Download>
+</div>
+
+```jsx Markdown
+<Download src="./all-about-ferns.pdf">
+  <Button intent="primary">Download PDF</Button>
+</Download>
+```
+
+## Properties
+
+<ParamField path="src" type="string" required={true}>
+  Path to your local asset (relative to current MDX file). The asset must be located within the `fern` folder.
+</ParamField>
+
+<ParamField path="children" type="React.ReactNode" required={true}>
+  The text or element to display as the click target for the download.
+</ParamField>
+
+<ParamField path="filename" type="string">
+  The filename to use for the downloaded asset. If not provided, the filename will be the same as the asset's name.
+</ParamField>
diff --git a/fern/products/docs/pages/component-library/default-components/embed.mdx b/fern/products/docs/pages/component-library/default-components/embed.mdx
deleted file mode 100644
index 43a0f2c97..000000000
--- a/fern/products/docs/pages/component-library/default-components/embed.mdx
+++ /dev/null
@@ -1,115 +0,0 @@
----
-title: "Embedded assets and files"
-description: "Embed local assets like PDFs, videos, and more in your documentation"
----
-
-Embed local assets like PDFs, videos, and other media directly in your documentation using native HTML5 tags. This allows you to include rich content without relying on external hosting.
-
-<Info title="Supported tags">
-  Fern supports using the `<embed src="..." />` tag to embed [external content](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/embed) and the `<source src="..." />` tag to embed [media or image sources](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/source).
-</Info>
-
-
-## Usage (embed video)
-
-<div className="highlight-frame">
-<embed src="./growing-fern.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%', borderRadius: '0.5rem' }} />
-</div>
-
-```jsx Markdown
-<embed src="./growing-fern.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%', borderRadius: '0.5rem' }} />
-```
-
-## Variants
-
-### Video file with video tag
-
-<Note>
-  Videos with audio will automatically play when the page loads. Using [`<video>` component](/learn/docs/content/write-markdown#embedding-videos) disables this behavior and provides more control over playback.
-</Note>
-
-<div className="highlight-frame">
-<video style={{ aspectRatio: '16 / 9', width: '100%', borderRadius: '0.5rem' }} controls>
-  <source src="./growing-fern.mp4" type="video/mp4" />
-</video>
-</div>
-
-```jsx Markdown
-<video style={{ aspectRatio: '16 / 9', width: '100%', borderRadius: '0.5rem' }} controls>
-  <source src="./growing-fern.mp4" type="video/mp4" />
-</video>
-```
-
-### PDF document
-
-<div className="highlight-frame">
-<embed src="./all-about-ferns.pdf" type="application/pdf"  style={{ width: '100%', height: '500px', borderRadius: '0.5rem' }} />
-</div>
-
-```jsx Markdown
-<embed src="./all-about-ferns.pdf" type="application/pdf" style={{ width: '100%', height: '500px', borderRadius: '0.5rem' }} />
-```
-
-## Downloadable assets
-
-<div className="highlight-frame">
-  <div className="highlight-frame-content">
-  <Download src="./all-about-ferns.pdf">
-    <Button intent="primary">Download PDF</Button>
-  </Download>
-  </div>
-</div>
-
-```jsx Markdown
-<Download src="./all-about-ferns.pdf">
-  <Button intent="primary">Download PDF</Button>
-</Download>
-```
-
-## Properties
-
-<ParamField path="src" type="string" required={true}>
-  Path to your local asset (relative to current MDX file)
-</ParamField>
-
-<ParamField path="type" type="string" required={true}>
-  MIME type of the asset (e.g. 'video/mp4', 'application/pdf')
-
-  <Accordion title="Common MIME types">
-
-  | File Type  | MIME Type         |
-  | ---------- | ----------------- |
-  | PDF        | `application/pdf` |
-  | MP4 Video  | `video/mp4`       |
-  | WebM Video | `video/webm`      |
-  | SVG Image  | `image/svg+xml`   |
-  | PNG Image  | `image/png`       |
-  | JPEG Image | `image/jpeg`      |
-
-  <Note>
-    The supported file types and behavior may vary depending on the browser and the type of content being embedded. For
-    video files, consider using MP4 format for maximum compatibility.
-  </Note>
-  </Accordion>
-</ParamField>
-
-### Downloadable asset properties
-
-Enable users to download assets from within your documentation, instead of linking to them, by using the `<Download>` component.
-
-<ParamField path="src" type="string" required={true}>
-  Path to your local asset (relative to current MDX file). The asset must be located within the `fern` folder.
-</ParamField>
-
-<ParamField path="children" type="React.ReactNode" required={true}>
-  The text or element to display as the click target for the download.
-</ParamField>
-
-<ParamField path="filename" type="string">
-  The filename to use for the downloaded asset. If not provided, the filename will be the same as the asset's name.
-</ParamField>
-
-<br />
-<br />
-
-
diff --git a/fern/products/docs/pages/component-library/default-components/overview.mdx b/fern/products/docs/pages/component-library/default-components/overview.mdx
index b71c659fa..8e04b2f66 100644
--- a/fern/products/docs/pages/component-library/default-components/overview.mdx
+++ b/fern/products/docs/pages/component-library/default-components/overview.mdx
@@ -63,11 +63,11 @@ Fern includes 20 built-in components for creating interactive documentation. Sel
     Code examples with syntax highlighting and interactive features
   </Card>
   <Card
-    title="Embed"
-    icon="fa-duotone fa-window-restore"
-    href="/docs/writing-content/components/embed"
+    title="Download"
+    icon="fa-duotone fa-download"
+    href="/docs/writing-content/components/download"
   >
-    Embedded local assets like PDFs, videos, and other media
+    Download PDFs and other assets
   </Card>
   <Card
     title="Endpoint request snippet"
diff --git a/fern/products/docs/pages/component-library/writing-content/markdown.mdx b/fern/products/docs/pages/component-library/writing-content/markdown.mdx
index 889090b05..e0e8cd264 100644
--- a/fern/products/docs/pages/component-library/writing-content/markdown.mdx
+++ b/fern/products/docs/pages/component-library/writing-content/markdown.mdx
@@ -67,7 +67,7 @@ Read the [Introduction](/learn/overview/introduction).
 
 ## Images
 
-You can use locally stored images or URLs to include images in your Markdown pages. Use either [Markdown syntax](https://www.markdownguide.org/basic-syntax/#images-1) or the [`<img>` HTML tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img) to insert the image.
+You can use locally stored images or URLs to include images in your Markdown pages. Use either [Markdown syntax](https://www.markdownguide.org/basic-syntax/#images-1) or the [`<img>` HTML tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img) to insert the image. Don't use the `<embed>` element, as it has inconsistent browser support.
 
 <Info title="Image paths">
   You can reference images using paths relative to the page's location (using `./` or `../`) or relative to the `fern` folder root (using `/`). For example, an image at `fern/assets/images/logo.png` can be referenced from any page as `/assets/images/logo.png`.
@@ -108,21 +108,26 @@ Common image attributes:
 For more details about the HTML image element and its attributes, see the [MDN documentation on the img element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img).
 </Note>
 
-## Embedding local assets
+## PDFs
 
-You can embed local assets in your Markdown pages using the [`<embed>` component](/learn/docs/content/components/embed). This is useful for displaying PDFs, images, videos, OpenAPI files, and other assets into your docs.
+Embed PDFs using the `<iframe>` element. Don't use the `<embed>` element, as it has inconsistent browser support.
 
-For example, to embed a video, use the following Markdown:
-
-```mdx
-<embed src="./path/to/asset.mp4" type="video/mp4" />
+<Tabs>
+<Tab title="Rendered video">
+<iframe src="../default-components/all-about-ferns.pdf" width="100%" height="500px" style={{ border: 'none', borderRadius: '0.5rem' }} />
+</Tab>
+<Tab title="HTML">
+```html
+<iframe src="../default-components/all-about-ferns.pdf" width="100%" height="500px" style={{ border: 'none', borderRadius: '0.5rem' }} />
 ```
+</Tab>
+</Tabs>
 
-<embed src="./embed-fern-waving.mp4" type="video/mp4" width="640px" height="360px" />
+## Videos
 
 ### Local videos
 
-You can embed videos in your documentation using the HTML `<video>` tag. This gives you control over video playback settings like autoplay, looping, and muting.
+You can embed videos in your documentation using the HTML `<video>` tag. This gives you control over video playback settings like autoplay, looping, and muting. Don't use the `<embed>` element, as it has inconsistent browser support.
 
 <Markdown src="/snippets/html-video-syntax-callout.mdx" />
 
@@ -189,7 +194,7 @@ Common video attributes:
 For more details about the HTML video element and its attributes, see the [MDN documentation on the video element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/video).
 </Note>
 
-## Embed YouTube or Loom videos
+### Embed YouTube or Loom videos
 
 You can embed videos from YouTube, Loom, Vimeo, and other streaming platforms using an `<iframe>` element.