Gif Support in MDX File

[theDeal]

What version of starlight are you using?

0.30.3

What is your idea?

Currently, Astro Starlight provides robust support for images, videos, and other media types in MDX files. However, there is no native support for displaying GIFs, which are commonly used for animations and dynamic content in modern web development. Adding support for GIFs in MDX files would enhance the multimedia capabilities of Astro Starlight, allowing developers to include animated content seamlessly.

Why is this feature necessary?

Use Case:

• Enhanced User Engagement: Many developers and designers rely on GIFs to showcase animated content, tutorials, demos, or interactive elements. With GIF support in MDX, content creators could use these animations directly in their documentation or content, improving user engagement and experience.
• Consistency & Flexibility: By supporting GIFs natively, developers would have consistent access to a variety of media types when working with MDX files, ensuring all content remains visually dynamic and engaging without relying on external libraries or custom workarounds.
• Improved Workflow: A seamless GIF experience within Astro Starlight would reduce the need for additional configuration or third-party solutions, streamlining workflows for both developers and content authors.

Do you have examples of this feature in other projects?

Right now, I'm using a workaround by placing GIFs in the public folder and rendering them directly with the <img> tag. While this works, it's not the most efficient solution for page load times. Every GIF needs to be manually copied to the public directory, and each time the page loads, the GIFs are fetched as static assets, which can increase the overall page size and slow down performance. A native GIF support in MDX would streamline this process, ensuring that GIFs are handled more efficiently, reducing unnecessary file transfers and improving load times.

Have a look here:
https://anleitung.sitzplan.digital/de/mitmachen/feedback/

Participation

• I am willing to submit a pull request for this feature.

[delucis]

Hi @theDeal! Thanks for the feedback. What happens currently when you use a GIF in an MDX file? I’d expect this to work, but maybe something in Astro’s asset handling is behaving unexpectedly.