MDX
astrowriting
Markdown with component support, useful when notes need richer examples or reusable UI blocks.
MDX is Markdown plus component syntax. In this site, posts already use .mdx when they need imports such as callouts, figures, tabs, or embedded media.
For everyday learning notes, plain .md is enough. When a note needs a richer demonstration, it can become MDX and still live in the same notes system.
When MDX helps
- A programming note needs an interactive example.
- A concept needs a custom callout component.
- A long note benefits from reusable visual blocks.
MDX works well with Content Collections because Astro can validate metadata and render each note consistently.
Local context
One-hop links around this note.