minor edits for clarity

Author: devalog

fern/products/docs/pages/component-library/writing-content/markdown.mdx

@@ -69,15 +69,27 @@ Read the [Introduction](/learn/overview/introduction).
 
 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.
 
+<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`.
+</Info>
+
 <Tabs>
   <Tab title="Markdown">
     ```markdown
-    ![Alt text](./path/to/image.png "Optional title")
+    <!-- Relative to page location -->
+    ![Alt text](../../assets/images/logo.png "Optional title")
+
+    <!-- Relative to fern folder root -->
+    ![Overview](/assets/images/logo.png)
     ```
   </Tab>
   <Tab title="HTML">
     ```html
-    <img src="../assets/images/overview.png" width="500px" height="auto" />
+    <!-- Relative to page location -->
+    <img src="../../assets/images/logo.png" width="500px" height="auto" />
+
+    <!-- Relative to fern folder root -->
+    <img src="/assets/images/logo.png" width="500px" height="auto" />
     ```
   </Tab>
 </Tabs>
@@ -96,16 +108,6 @@ 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>
 
-### Image paths
-
-When referencing images, you can use either relative paths (`./` or `../`) or paths relative to the root of the `fern` folder by using `/`. For example, if you have an image at `fern/assets/images/overview.png`, you can reference it from any page using `/assets/images/overview.png`:
-
-```markdown
-![Overview](/assets/images/overview.png)
-```
-
-This is equivalent to using a relative path like `../../assets/images/overview.png`, but is more concise and doesn't depend on the current page's location in the folder structure.
-
 ## Embedding local assets
 
 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.