Remote Hero Images in Astro MDX

Web Team · 8/10/2025

Code editor on screen

Remote hero images keep repos lean and avoid missing asset builds.

Guidelines

  • Use absolute HTTPS URLs in frontmatter.
  • Add alt text and loading="lazy".
  • Avoid text overlays on the image itself; place text below.

Gotchas

  • Don’t reference local files in frontmatter.
  • Prefer consistent aspect ratios to reduce layout shift.