🌿 In Crescita

Costruire Componenti Interattivi con MDX

Scopri come usare MDX per aggiungere componenti interattivi ai tuoi articoli

Di Antonio Rossi Piantato 10 gennaio 2026
Indice

Cos’è MDX?

MDX è uno strumento potente che ti permette di usare componenti JSX direttamente nei tuoi file markdown. Questo significa che puoi scrivere articoli che includono elementi interattivi, non solo contenuti statici.

Perché Usare MDX?

Il markdown tradizionale ha delle limitazioni quando serve interattività:

  • Limitato all’HTML — Il markdown genera HTML statico
  • Nessun comportamento dinamico — Non si possono aggiungere elementi interattivi
  • Difficile da estendere — Aggiungere funzionalità personalizzate richiede soluzioni alternative

MDX risolve questi problemi combinando markdown con JSX.

Esempio: Creare un Componente Contatore

Ecco un semplice componente contatore React che potresti usare in un file MDX:

export function Counter() {
  const [count, setCount] = React.useState(0);

  return (
    <button onClick={() => setCount(count + 1)}>Conteggio: {count}</button>
  );
}

Vantaggi in Astro

In Astro, MDX ti offre:

  1. Facile da scrivere — Ha ancora l’aspetto e la sensazione del markdown
  2. Potente — Accesso completo a JavaScript e componenti
  3. Interattivo — Aggiungi interattività lato client dove serve
  4. Type-safe — Con supporto TypeScript

Buone Pratiche

Quando usi MDX nel tuo blog:

  • Mantieni i componenti semplici e focalizzati
  • Usa MDX con parsimonia per gli elementi interattivi
  • Considera le implicazioni sulle prestazioni
  • Documenta chiaramente i componenti personalizzati

Conclusione

MDX è un ottimo modo per aggiungere interattività al tuo blog Astro mantenendo la semplicità e la leggibilità del markdown. È perfetto per blog tecnici che necessitano di esempi di codice, diagrammi o demo interattive.

Se sei nuovo ad Astro, inizia prima con iniziare con Astro.

v0.9.5