Bienvenue sur notre Blog avec MDX

Découvrez comment MDX combine la simplicité du Markdown avec la puissance des composants React pour créer du contenu riche et interactif.

ST

ShipSaaS Team

5 janvier 20255 min

Bienvenue sur notre Blog avec MDX

Ceci est un exemple de contenu MDX qui combine la simplicité du Markdown avec la puissance des composants React. MDX vous permet d'écrire du contenu riche et interactif.

Qu'est-ce que MDX ?

MDX est un format de fichier qui vous permet d'utiliser du JSX dans vos documents Markdown. Cela signifie que vous pouvez :

  • Écrire du contenu en Markdown standard
  • Intégrer des composants React personnalisés
  • Créer des expériences interactives
  • Maintenir la lisibilité du code

Exemple de formatage

Voici quelques exemples de formatage Markdown qui fonctionnent parfaitement :

  1. Texte en gras et texte en italique
  2. Code inline avec des backticks
  3. Liens vers des sites externes
  4. Liens internes vers d'autres pages

Citation importante MDX révolutionne la façon dont nous créons du contenu technique en combinant la simplicité du Markdown avec la flexibilité de React.

Exemples de code

JavaScript

javascript
// Exemple de fonction React
function WelcomeMessage({name}) {
  return (
    <div className="welcome">
      <h2>Bonjour {name} !</h2>
      <p>Bienvenue dans notre application Next.js</p>
    </div>
  )
}

export default WelcomeMessage

TypeScript

typescript
interface User {
  id: number
  name: string
  email: string
  isActive: boolean
}

const createUser = (userData: Omit<User, 'id'>): User => {
  return {
    id: Date.now(),
    ...userData,
  }
}

CSS

css
.blog-container {
  max-width: 800px;
  margin: 0 auto;
  padding: 2rem;
  font-family: 'Inter', sans-serif;
}

.highlight {
  background: linear-gradient(120deg, #a8edea 0%, #fed6e3 100%);
  padding: 0.2em 0.4em;
  border-radius: 4px;
}

Listes et structures

Technologies utilisées dans ce projet

  • Next.js 15 - Framework React avec App Router
  • TypeScript - Typage statique pour JavaScript
  • Tailwind CSS - Framework CSS utilitaire
  • MDX - Markdown avec composants React
  • ShadCN UI - Composants UI modernes
  • Next Intl - Internationalisation

Étapes de développement

  1. Configuration initiale

    • Installation des dépendances
    • Configuration de Next.js
    • Setup de TypeScript
  2. Développement

    • Création des composants
    • Implémentation des pages
    • Tests et optimisation
  3. Déploiement

    • Build de production
    • Optimisation des performances
    • Mise en ligne

Tableau des fonctionnalités

FonctionnalitéDescriptionStatut
AuthentificationSystème de connexion sécuriséImplémenté
DashboardInterface utilisateurImplémenté
PaiementsIntégration StripeImplémenté
Blog MDXSystème de blog avec MDXEn cours
OrganisationsGestion multi-tenantImplémenté

Démonstration des Composants MDX

Cette section présente tous les composants MDX disponibles dans ce blog.

Callouts

Les callouts permettent de mettre en évidence des informations importantes.

Information

Information - Ceci est un callout de type info pour partager des informations utiles.

Attention

Attention - Ceci est un callout de type warning pour avertir l'utilisateur.

Succès

Succès - Ceci est un callout de type success pour confirmer une action réussie.

Erreur

Erreur - Ceci est un callout de type error pour signaler un problème.

Steps (Étapes)

Les étapes permettent de présenter un processus de manière claire.

  1. Installation

    Commencez par installer les dépendances avec pnpm install.

  2. Configuration

    Configurez vos variables d'environnement dans .env.local.

  3. Développement

    Lancez le serveur de développement avec pnpm dev.

Tabs (Onglets)

Les onglets permettent d'organiser du contenu similaire.

bash npm install next react react-dom

Vidéo YouTube

Intégration d'une vidéo YouTube :

Vidéo Vimeo

Intégration d'une vidéo Vimeo :

Tweet / X

Intégrez facilement des tweets dans votre contenu :

Vous pouvez aussi utiliser l'ID directement :

Excalidraw

Intégrez des diagrammes Excalidraw interactifs :

Diagramme illustrant l'architecture - Voir en plein écran

Vous pouvez aussi utiliser des liens Excalidraw avec JSON :

Exemple de diagramme Excalidraw - Voir en plein écran

Code avec nom de fichier

typescript
export function Example() {
  return <div>Hello World</div>
}

Images

Vous pouvez intégrer des images avec Next/Image optimisé :

Image exemple

Récapitulatif des composants disponibles

ComposantUsageExemple
CalloutMessages d'alerte (info, warning, etc.)<Callout type="info">...</Callout>
Steps/StepGuide étape par étape<Steps><Step title="...">...</Step></Steps>
Tabs/TabContenu avec onglets<Tabs><Tab value="..." label="...">...</Tab></Tabs>
VideoVidéos YouTube, Vimeo ou MP4<Video src="..." title="..." />
TweetIntégration de tweets X/Twitter<Tweet url="..." /> ou <Tweet id="..." />
ExcalidrawDiagrammes interactifs<Excalidraw src="..." alt="..." />
ImageImages optimisées Next.js<Image src="..." alt="..." />

Conclusion

MDX offre une expérience de création de contenu exceptionnelle en combinant :

  • Simplicité : Syntaxe Markdown familière
  • Flexibilité : Composants React intégrés
  • Performance : Rendu optimisé côté serveur
  • Maintenabilité : Code structuré et lisible

Cette approche révolutionne la création de contenu technique et permet de créer des expériences riches et interactives.

Prêt à commencer ? Explorez notre documentation ou visitez notre page de pricing pour découvrir nos offres.

#mdx#nextjs#react#blog

Échangeons

Prêt à relier votre offre ?

Présentez-nous le fonctionnement de votre programme et les endroits où l’exécution perd son contexte.

Contacter l’équipe

Un échange ciblé sur votre contexte opérationnel

Newsletter

Restez informé de nos derniers articles et actualités du développement web.

Pas de spam, désabonnement à tout moment