diff --git a/website/docs/guides/markdown-features/markdown-features-assets.mdx b/website/docs/guides/markdown-features/markdown-features-assets.mdx
index 86d280bd97..8e0fa107f2 100644
--- a/website/docs/guides/markdown-features/markdown-features-assets.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-assets.mdx
@@ -22,29 +22,29 @@ Let's imagine the following file structure:
 
 ## Images {#images}
 
-You can use images in Markdown, or by requiring them and using a JSX image tag:
+You can display images in three different ways: Markdown syntax, JSX require or ES imports syntax.
+
+Display images using simple Markdown syntax:
 
 ```mdx
-# My Markdown page
+![Example banner](./assets/docusaurus-asset-example-banner.png)
+```
 
+Display images using inline CommonJS `require` in JSX image tag:
+
+```mdx
 <img
   src={require('./assets/docusaurus-asset-example-banner.png').default}
   alt="Example banner"
 />
-
-or
-
-![Example banner](./assets/docusaurus-asset-example-banner.png)
 ```
 
-The ES imports syntax also works:
+Display images using ES `import` syntax and JSX image tag:
 
 ```mdx
-# My Markdown page
-
 import myImageUrl from './assets/docusaurus-asset-example-banner.png';
 
-<img src={myImageUrl} alt="My image alternative text" />
+<img src={myImageUrl} alt="Example banner" />
 ```
 
 This results in displaying the image: