From 5b1375e49b1943ef87060fa515eebbc3d2ef4b5b Mon Sep 17 00:00:00 2001 From: PolyWolf <31190026+p0lyw0lf@users.noreply.github.com> Date: Fri, 21 Feb 2025 21:32:14 -0500 Subject: [PATCH 1/6] Update images.mdx --- src/content/docs/en/guides/images.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/en/guides/images.mdx b/src/content/docs/en/guides/images.mdx index 4f00cdf0c2d9b..c6ef992301f08 100644 --- a/src/content/docs/en/guides/images.mdx +++ b/src/content/docs/en/guides/images.mdx @@ -271,7 +271,7 @@ Alternatively, the CDN may provide its own SDKs to more easily integrate in an A ## Images in Markdown files -Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax works with Astro's [Image Service API](/en/reference/image-service-reference/) to optimize your local images stored in `src/`. Remote images and images stored in the `public/` folder are not optimized. +Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax works with Astro's [Image Service API](/en/reference/image-service-reference/) to optimize your local images stored in `src/`. Images stored in the `public/` folder are not optimized. After Astro 5.4.0, remote images included with this syntax are optimized according to your configuration. ```md From 590f8c05896f6be6a80235db27d8216a34e9f1e3 Mon Sep 17 00:00:00 2001 From: PolyWolf <31190026+p0lyw0lf@users.noreply.github.com> Date: Fri, 21 Feb 2025 21:41:04 -0500 Subject: [PATCH 2/6] follow Since guidance --- src/content/docs/en/guides/images.mdx | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/src/content/docs/en/guides/images.mdx b/src/content/docs/en/guides/images.mdx index c6ef992301f08..6c64bfcc7df9f 100644 --- a/src/content/docs/en/guides/images.mdx +++ b/src/content/docs/en/guides/images.mdx @@ -271,7 +271,7 @@ Alternatively, the CDN may provide its own SDKs to more easily integrate in an A ## Images in Markdown files -Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax works with Astro's [Image Service API](/en/reference/image-service-reference/) to optimize your local images stored in `src/`. Images stored in the `public/` folder are not optimized. After Astro 5.4.0, remote images included with this syntax are optimized according to your configuration. +Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax works with Astro's [Image Service API](/en/reference/image-service-reference/) to optimize your local images stored in `src/`. Images stored in the `public/` folder are not optimized. ```md @@ -295,6 +295,12 @@ The `` tag is not supported for local images, and the `` and `

+ +Before 5.4.0, remote images were never optimized. After Astro 5.4.0, remote images included with this syntax are optimized according to your configuration. To opt out of optimization for remote images, use the `` tag. + ## Images in MDX files You can use Astro's `` and `` components in your `.mdx` files by importing both the component and your image. Use them just as they are [used in `.astro` files](#images-in-astro-files). The JSX `` tag is also supported for unprocessed images and [uses the same image import as the HTML `` tag](#display-unprocessed-images-with-the-html-img-tag). From b4a4f3dc017147e3a8187a6ab435d2e38655da10 Mon Sep 17 00:00:00 2001 From: PolyWolf <31190026+p0lyw0lf@users.noreply.github.com> Date: Mon, 24 Feb 2025 20:49:32 -0500 Subject: [PATCH 3/6] Update src/content/docs/en/guides/images.mdx Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com> --- src/content/docs/en/guides/images.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/en/guides/images.mdx b/src/content/docs/en/guides/images.mdx index 6c64bfcc7df9f..ae5676f4676c8 100644 --- a/src/content/docs/en/guides/images.mdx +++ b/src/content/docs/en/guides/images.mdx @@ -271,7 +271,7 @@ Alternatively, the CDN may provide its own SDKs to more easily integrate in an A ## Images in Markdown files -Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax works with Astro's [Image Service API](/en/reference/image-service-reference/) to optimize your local images stored in `src/`. Images stored in the `public/` folder are not optimized. +Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax works with Astro's [Image Service API](/en/reference/image-service-reference/) to optimize your local images stored in `src/` and remote images. Images stored in the `public/` folder are never optimized. ```md From a0f13fe1a5ff5a4b19630a81ecaa65a4d5d9672e Mon Sep 17 00:00:00 2001 From: PolyWolf <31190026+p0lyw0lf@users.noreply.github.com> Date: Mon, 24 Feb 2025 20:52:38 -0500 Subject: [PATCH 4/6] Update images.mdx --- src/content/docs/en/guides/images.mdx | 10 ++-------- 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/src/content/docs/en/guides/images.mdx b/src/content/docs/en/guides/images.mdx index ae5676f4676c8..7f0f99057a7a7 100644 --- a/src/content/docs/en/guides/images.mdx +++ b/src/content/docs/en/guides/images.mdx @@ -291,15 +291,9 @@ Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax work ![Astro](https://example.com/images/remote-image.png) ``` -The `` tag is not supported for local images, and the `` and `` components are unavailable in `.md` files. +The HTML tag can also be used to display images stored in `public/` or remote images without any image optimization or processing. However, `` is not supported for your local images in `src`. -If you require more control over your image attributes, we recommend using [Astro's MDX integration](/en/guides/integrations-guide/mdx/) to add support for`.mdx` file format. MDX allows adding components to Markdown and there are additional [image options available in MDX](#images-in-mdx-files). - -### Remote Images in Markdown Files - -

- -Before 5.4.0, remote images were never optimized. After Astro 5.4.0, remote images included with this syntax are optimized according to your configuration. To opt out of optimization for remote images, use the `` tag. +The `` and `` components are unavailable in .md files. If you require more control over your image attributes, we recommend using [Astro's MDX integration](/en/guides/integrations-guide/mdx/) to add support for`.mdx` file format. MDX allows additional [image options available in MDX](#images-in-mdx-files), including combining components with Markdown syntax. ## Images in MDX files From a0ad9ada73f77c980aad4c7d73ceafed8faaf808 Mon Sep 17 00:00:00 2001 From: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com> Date: Tue, 25 Feb 2025 11:34:51 -0400 Subject: [PATCH 5/6] inline code formatting --- src/content/docs/en/guides/images.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/en/guides/images.mdx b/src/content/docs/en/guides/images.mdx index 7f0f99057a7a7..070fa72850caa 100644 --- a/src/content/docs/en/guides/images.mdx +++ b/src/content/docs/en/guides/images.mdx @@ -291,7 +291,7 @@ Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax work ![Astro](https://example.com/images/remote-image.png) ``` -The HTML tag can also be used to display images stored in `public/` or remote images without any image optimization or processing. However, `` is not supported for your local images in `src`. +The HTML `` tag can also be used to display images stored in `public/` or remote images without any image optimization or processing. However, `` is not supported for your local images in `src`. The `` and `` components are unavailable in .md files. If you require more control over your image attributes, we recommend using [Astro's MDX integration](/en/guides/integrations-guide/mdx/) to add support for`.mdx` file format. MDX allows additional [image options available in MDX](#images-in-mdx-files), including combining components with Markdown syntax. From ff36f252e307de02d418209d4f9a53e20a5a70a2 Mon Sep 17 00:00:00 2001 From: Yan <61414485+yanthomasdev@users.noreply.github.com> Date: Tue, 25 Feb 2025 15:16:36 -0300 Subject: [PATCH 6/6] Update src/content/docs/en/guides/images.mdx --- src/content/docs/en/guides/images.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/en/guides/images.mdx b/src/content/docs/en/guides/images.mdx index 070fa72850caa..1d1eed2af3057 100644 --- a/src/content/docs/en/guides/images.mdx +++ b/src/content/docs/en/guides/images.mdx @@ -293,7 +293,7 @@ Use standard Markdown `![alt](src)` syntax in your `.md` files. This syntax work The HTML `` tag can also be used to display images stored in `public/` or remote images without any image optimization or processing. However, `` is not supported for your local images in `src`. -The `` and `` components are unavailable in .md files. If you require more control over your image attributes, we recommend using [Astro's MDX integration](/en/guides/integrations-guide/mdx/) to add support for`.mdx` file format. MDX allows additional [image options available in MDX](#images-in-mdx-files), including combining components with Markdown syntax. +The `` and `` components are unavailable in `.md` files. If you require more control over your image attributes, we recommend using [Astro's MDX integration](/en/guides/integrations-guide/mdx/) to add support for `.mdx` file format. MDX allows additional [image options available in MDX](#images-in-mdx-files), including combining components with Markdown syntax. ## Images in MDX files