Présentation
À quoi sert cet éditeur ?
NfzNotionMarkdownEditor permet d’écrire du Markdown dans une interface visuelle sans abandonner le fichier Markdown comme format principal. C’est utile lorsqu’une application Nuxt doit proposer une expérience d’écriture confortable tout en gardant un contenu simple à versionner, publier ou envoyer à une API.
Le principe est volontairement simple : votre application fournit une chaîne Markdown avec v-model, l’utilisateur la modifie dans TipTap, puis le composant renvoie le Markdown mis à jour.
<NfzNotionMarkdownEditor v-model="markdown" />Vous n’avez donc pas besoin d’adopter un format de stockage propre à l’éditeur.
Ce que l’utilisateur peut faire
L’éditeur couvre les besoins courants d’un document riche : titres, listes, tâches, citations, tableaux, blocs de code, images, vidéos et diagrammes Mermaid. Il ajoute aussi des outils pratiques pour travailler plus vite : menu /, poignée de déplacement, menu d’actions sur les blocs, raccourcis clavier, barre d’état et aperçu Markdown.
Pour les documents plus techniques, un mode source permet de retrouver le Markdown brut. C’est particulièrement utile avec VitePress, où certaines syntaxes avancées doivent rester exactement telles qu’elles ont été écrites.
Comment le contenu est protégé
Le Markdown courant est transformé en contenu visuel éditable. Lorsqu’une syntaxe VitePress ne peut pas être représentée sans perte — par exemple un groupe de code, une directive Shiki ou un composant Vue — elle est conservée comme source. Vous pouvez alors la modifier dans le mode Markdown plutôt que de risquer une conversion incorrecte.
Quel mode choisir ?
| Si vous voulez… | Choisissez… |
|---|---|
| Ajouter l’éditeur rapidement à une application Nuxt 4 | Module Nuxt complet |
| Étendre directement votre application avec la configuration du projet | Nuxt Layer |
| Garder uniquement les fonctions de base et réduire les dépendances activées | Module léger |
Pour la majorité des nouveaux projets, commencez par le module Nuxt. Vous pourrez ensuite désactiver les fonctions dont vous n’avez pas besoin.