Saltar al contenido principal
Si no puedes hacer clic en el botón Publish del editor y al pasar el cursor por encima aparece el tooltip de error Fix invalid MDX before publishing, al menos una página de tu branch tiene MDX que no se puede parsear. El editor bloquea la publicación hasta que todas las páginas de la branch se parseen correctamente. Esto evita que la sintaxis rota llegue a tu sitio en producción. El tooltip te indica cuántas páginas tienen errores. El mismo error bloquea Request review en las feature branches. Entre las causas habituales están:
  • Una etiqueta de componente sin cerrar, como un <Note> sin su </Note> correspondiente.
  • JSX mal formado en el cuerpo de la página, como una llave sin cerrar en una expresión.
  • Frontmatter que no es YAML válido, como una sangría inconsistente o unas comillas sin cerrar.
Mientras una página tiene MDX no válido o YAML de frontmatter no válido, esas ediciones permanecen locales para ti. Los compañeros que editen la misma página solo reciben contenido válido, así que un error de sintaxis que introduzcas no sobrescribe su trabajo. Consulta Colaborar en el editor para ver cómo gestiona la edición en tiempo real el contenido no válido.

​
Localizar la página afectada

Si el tooltip indica una sola página con errores, normalmente es la que estás editando. Si indica más de una, o no sabes qué página tiene el error, revisa cada página que hayas modificado en la branch:
  1. Haz clic en Publish en la barra de herramientas para abrir el menú de publicación. El menú lista todos los archivos modificados en tu branch.
  2. Abre cada archivo modificado por turno y busca errores de parseo en el modo source (ver más abajo). Las páginas que se parsean correctamente se muestran con normalidad. La página rota muestra el error.

​
Corregir el error manualmente

  1. Abre la página afectada en el editor.
  2. Cambia al modo source con Cmd + Shift + S (macOS) o Ctrl + Shift + S (Windows). El modo source resalta el MDX no válido y muestra el error de parseo.
  3. Corrige la sintaxis. Una vez que la página se parsea, el error desaparece y el botón Publish vuelve a estar disponible.
Para errores de frontmatter, comprueba que cada valor sea YAML válido: entrecomilla las cadenas que contengan dos puntos o caracteres especiales, mantén una sangría coherente y cierra todas las comillas. Consulta Metadatos de la página para ver los campos de frontmatter admitidos.

​
Corregir el error con el agente

  1. Abre el panel del editor.
  2. Pide al agente que corrija cualquier MDX o YAML de frontmatter no válido. Sin una mención, el agente usa la página que tienes abierta como contexto inicial. Para corregir errores en toda la branch con una sola petición, pide al agente que encuentre y repare todas las páginas con MDX no válido. Consulta Agente.

Temas relacionados

Solución de problemasInsigniaInicio rápido