Astro Guideline: Markdown — Use MDX for components. Description: Components in markdown content. Do: @astrojs/mdx for interactive docs. Don't: Plain markdown with workarounds. Good Example: <Component /> in .mdx. Bad Example: HTML in .md files. Severity: Medium. Docs: https://docs.astro.build/en/guides/integrations-guide/mdx/.