Bouton Publish désactivé à cause d'un MDX non valide
Pourquoi le bouton Publish de l'éditeur est désactivé avec le message « Fix invalid MDX before publishing » et comment trouver et corriger la page en erreur.
Si vous ne pouvez pas cliquer sur le bouton Publish dans l’éditeur et que le fait de le survoler affiche l’infobulle d’erreur Fix invalid MDX before publishing, au moins une page de votre branch contient un MDX qui ne parse pas. L’éditeur bloque la publication tant que toutes les pages de la branch ne parsent pas correctement. Cela empêche qu’une syntaxe cassée n’atteigne votre site publié.
L’infobulle vous indique combien de pages ont des erreurs. La même erreur bloque Request review sur les feature branches. Les causes courantes comprennent :
- Une balise de composant non fermée, comme un
<Note>sans</Note>correspondant. - Un JSX mal formé dans le corps de la page, comme une accolade non fermée dans une expression.
- Un frontmatter qui n’est pas du YAML valide, comme une indentation incohérente ou une guillemet non fermée.
Tant qu’une page contient un MDX non valide ou un frontmatter YAML non valide, ces modifications restent locales à votre poste. Vos collègues qui modifient la même page ne reçoivent que du contenu valide, de sorte qu’une erreur de syntaxe que vous introduisez n’écrase pas leur travail. Consultez Collaborer dans l’éditeur pour comprendre comment l’édition en temps réel gère le contenu non valide.
- Ouvrez la page concernée dans l’éditeur.
- Basculez en mode source avec Cmd + Shift + S (macOS) ou Ctrl + Shift + S (Windows). Le mode source met en évidence le MDX non valide et affiche l’erreur de parsing.
- Corrigez la syntaxe. Une fois la page parsée, l’erreur disparaît et le bouton Publish redevient disponible.
- Ouvrez le panneau de l’éditeur.
- Demandez à l’agent de corriger tout MDX ou frontmatter YAML non valide.