Tricky implementation traps worth remembering
A real MDX / Astro content-processing gotcha that surfaced building the docs site. Captured here so future sessions don't repeat the same bug.
