mintlify · mintlify · Sep 5, 2026 · Sep 5, 2026 · Sep 22, 2026 · Sep 23, 2026
diff --git a/docs.json b/docs.json
@@ -481,7 +481,8 @@
                   "help-center/preview-deployment-not-created-for-fork-branch",
                   "help-center/branch-missing-from-editor-branch-list",
                   "help-center/style-card-icons-with-custom-css",
-                  "help-center/can-i-rename-my-deployment-or-organization"
+                  "help-center/can-i-rename-my-deployment-or-organization",
+                  "help-center/publish-button-disabled-invalid-mdx"
                 ]
               }
             ]

diff --git a/editor/collaborate.mdx b/editor/collaborate.mdx
@@ -20,7 +20,7 @@
  <img src="/images/editor/comment-dark.png" alt="The comment button in the floating toolbar above selected text in the editor." className="hidden dark:block" />
 </Frame>

 React to a comment to acknowledge it without replying. Hover over a comment, click the **Add reaction** button, and choose an emoji. Search the picker to find a specific emoji. Click an existing reaction to add or remove yours. Hover over a reaction to see who reacted. Reacting to someone else's comment notifies the comment's author.

 All [roles](/dashboard/roles) can comment and reply, including viewers. Only editors and admins can resolve threads. Resolving a thread removes it from the sidebar and clears the highlight from the page.

@@ -61,8 +61,11 @@
 
 When multiple people open the same page on the same branch, they edit together. Each person's cursor and edits are visible to everyone, with avatars in the toolbar.
 
+Real-time editing works in both visual mode and source mode. You can edit the MDX in source mode while a teammate works in visual mode on the same page. Their cursor and selection appear in your editor, and yours appear in theirs, including in the title and description fields.
+
 - Changes from all collaborators merge automatically. Two people editing the same section won't create conflicts.
 - Undo only affects your own edits.
 - If you lose your connection, edits save locally and sync when you reconnect.
+- In source mode, invalid MDX or frontmatter YAML stays local to you until you fix it. Teammates only receive valid content, and invalid MDX [blocks publishing](/editor/publish#invalid-mdx-blocks-publishing) until it's repaired.
 
 When the [Mintlify agent](/agent) edits a page through the API or MCP, it appears like any other collaborator, with an avatar and a live cursor at its most recent edit. The cursor clears when the agent finishes.
diff --git a/editor/index.mdx b/editor/index.mdx
@@ -43,9 +43,9 @@ The editor loads by default when you open your [dashboard](https://app.mintlify.
 
 **Visual mode** renders your page as you type. Press <kbd>/</kbd> to open the component menu and insert components.
 
-**Source mode** gives you direct access to the MDX. Use it for precise control over component properties and frontmatter.
+**Source mode** gives you direct access to the MDX. Use it for precise control over component properties and frontmatter. Type `<` to autocomplete components: the menu lists documented components with each one's description, props, and an example. Inside a tag, the menu suggests that component's props and values, including page links, image paths, and icon names. Hover over a component or prop name to see its documentation in a popover. To open the popover at your cursor, press <kbd>Cmd</kbd> + <kbd>.</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>.</kbd> (Windows).
 
-Both modes edit the same file. Switch between them with <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows).
+Both modes edit the same file and support [real-time collaboration](/editor/collaborate#real-time-editing). Switch between them with <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows).
 
 For the components you can insert, see [Components](/components). For MDX syntax, see [Format text](/create/text) and [Format code](/create/code).
 

diff --git a/editor/keyboard-shortcuts.mdx b/editor/keyboard-shortcuts.mdx
@@ -94,6 +94,8 @@ Source mode uses CodeMirror. Most common code editor shortcuts work, along with
 | **Bold** (wraps in `**`) | <kbd>Cmd</kbd> + <kbd>B</kbd> | <kbd>Ctrl</kbd> + <kbd>B</kbd> |
 | **Italic** (wraps in `_`) | <kbd>Cmd</kbd> + <kbd>I</kbd> | <kbd>Ctrl</kbd> + <kbd>I</kbd> |
 | **Toggle comment** | <kbd>Cmd</kbd> + <kbd>/</kbd> | <kbd>Ctrl</kbd> + <kbd>/</kbd> |
+| **Format document** | <kbd>Cmd</kbd> + <kbd>S</kbd> | <kbd>Ctrl</kbd> + <kbd>S</kbd> |
+| **Show component documentation** at cursor | <kbd>Cmd</kbd> + <kbd>.</kbd> | <kbd>Ctrl</kbd> + <kbd>.</kbd> |
 | **Fold all** | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> |
 | **Unfold all** | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> |
 | **Indent line** | <kbd>Tab</kbd> | <kbd>Tab</kbd> |

diff --git a/editor/publish.mdx b/editor/publish.mdx
@@ -39,6 +39,10 @@
 
 Only one publish can happen at a time per branch. If a teammate publishes to the same branch, wait for their publish to complete before trying again.
 
+### Invalid MDX blocks publishing
+
+If any page on your branch has invalid MDX, the editor disables the **Publish** button until you fix it. Hover over the button to see how many pages have errors, then open each page in source mode to see and fix the error. See [Publish button disabled because of invalid MDX](/help-center/publish-button-disabled-invalid-mdx) for details.
+
 <Note>
   Your live site updates after Mintlify builds and deploys your changes. This typically takes 30 seconds to a few minutes. Check the deployment status on your [dashboard](https://app.mintlify.com).
 </Note>
@@ -67,6 +71,6 @@

 ## Auto publish

 If your deployment has [auto publish](/editor/settings#main-branch-autocommits) turned on, the editor commits to your deployment branch shortly after you stop typing. The branch selector and **Publish** button are hidden. There is no pending state and no review step.

 Edits on feature branches created from the editor commit automatically either way, but they never publish unless you merge them into your deployment branch.
diff --git a/es.json b/es.json
@@ -459,7 +459,8 @@
             "es/help-center/preview-deployment-not-created-for-fork-branch",
             "es/help-center/branch-missing-from-editor-branch-list",
             "es/help-center/style-card-icons-with-custom-css",
-            "es/help-center/can-i-rename-my-deployment-or-organization"
+            "es/help-center/can-i-rename-my-deployment-or-organization",
+            "es/help-center/publish-button-disabled-invalid-mdx"
           ]
         }
       ]

diff --git a/es/editor/collaborate.mdx b/es/editor/collaborate.mdx
@@ -77,8 +77,11 @@ Las menciones funcionan en páginas privadas para los miembros que ya tienen acc
 
 Cuando varias personas abren la misma página en la misma branch, editan conjuntamente. El cursor y las ediciones de cada persona son visibles para todos, con avatares en la barra de herramientas.
 
+La edición en tiempo real funciona tanto en el modo visual como en el modo source. Puede editar el MDX en el modo source mientras un compañero trabaja en el modo visual en la misma página. El cursor y la selección de su compañero aparecen en su editor, y los suyos aparecen en el del compañero, incluso en los campos de título y descripción.
+
 - Los cambios de todos los colaboradores se combinan automáticamente. Que dos personas editen la misma sección no genera conflictos.
 - Deshacer solo afecta a sus propias ediciones.
 - Si pierde la conexión, sus ediciones se guardan localmente y se sincronizan cuando vuelve a conectarse.
+- En el modo source, el MDX o el YAML del frontmatter no válidos se mantienen locales para usted hasta que los corrige. Sus compañeros solo reciben contenido válido, y el MDX no válido [bloquea la publicación](/es/editor/publish#invalid-mdx-blocks-publishing) hasta que se repara.
 
 Cuando el [agente de Mintlify](/es/agent) edita una página a través de la API o de MCP, aparece como cualquier otro colaborador, con un avatar y un cursor en vivo en su edición más reciente. El cursor desaparece cuando el agente termina.
diff --git a/es/editor/index.mdx b/es/editor/index.mdx
@@ -55,9 +55,9 @@ El editor se carga de forma predeterminada cuando abre su [dashboard](https://ap
 
 **El modo visual** representa su página a medida que escribe. Presione <kbd>/</kbd> para abrir el menú de componentes e insertar componentes.
 
-**El modo source** le da acceso directo al MDX. Úselo para tener control preciso sobre las propiedades de los componentes y el frontmatter.
+**El modo source** le da acceso directo al MDX. Úselo para tener control preciso sobre las propiedades de los componentes y el frontmatter. Escriba `<` para autocompletar componentes: el menú muestra los componentes documentados con la descripción, las props y un ejemplo de cada uno. Dentro de una etiqueta, el menú sugiere las props y los valores de ese componente, incluidos enlaces a páginas, rutas de imágenes y nombres de iconos. Pase el cursor sobre el nombre de un componente o de una prop para ver su documentación en un popover. Para abrir el popover en la posición del cursor, presione <kbd>Cmd</kbd> + <kbd>.</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>.</kbd> (Windows).
 
-Ambos modos editan el mismo archivo. Cambie entre ellos con <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows).
+Ambos modos editan el mismo archivo y admiten la [colaboración en tiempo real](/es/editor/collaborate#real-time-editing). Cambie entre ellos con <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows).
 
 Para conocer los componentes que puede insertar, consulte [Componentes](/es/components). Para la sintaxis de MDX, consulte [Dar formato al texto](/es/create/text) y [Dar formato al código](/es/create/code).
 

diff --git a/es/editor/keyboard-shortcuts.mdx b/es/editor/keyboard-shortcuts.mdx
@@ -134,6 +134,8 @@ El modo source usa CodeMirror. Funcionan la mayoría de los atajos habituales de
 | **Negrita** (envuelve en `**`) | <kbd>Cmd</kbd> + <kbd>B</kbd> | <kbd>Ctrl</kbd> + <kbd>B</kbd> |
 | **Cursiva** (envuelve en `_`) | <kbd>Cmd</kbd> + <kbd>I</kbd> | <kbd>Ctrl</kbd> + <kbd>I</kbd> |
 | **Comentar o descomentar** | <kbd>Cmd</kbd> + <kbd>/</kbd> | <kbd>Ctrl</kbd> + <kbd>/</kbd> |
+| **Dar formato al documento** | <kbd>Cmd</kbd> + <kbd>S</kbd> | <kbd>Ctrl</kbd> + <kbd>S</kbd> |
+| **Mostrar documentación del componente** en el cursor | <kbd>Cmd</kbd> + <kbd>.</kbd> | <kbd>Ctrl</kbd> + <kbd>.</kbd> |
 | **Plegar todo** | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> |
 | **Desplegar todo** | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> |
 | **Aumentar la sangría de la línea** | <kbd>Tab</kbd> | <kbd>Tab</kbd> |

diff --git a/es/editor/publish.mdx b/es/editor/publish.mdx
@@ -47,6 +47,14 @@ Si no hay cambios pendientes, el editor deshabilita las acciones de publicar y g
 
 Solo puede realizarse una publicación a la vez por branch. Si un compañero publica en la misma branch, espere a que termine su publicación antes de volver a intentarlo.
 
+<div id="invalid-mdx-blocks-publishing">
+
+### El MDX no válido bloquea la publicación
+
+</div>
+
+Si alguna página de su branch tiene MDX no válido, el editor deshabilita el botón **Publish** hasta que lo corrija. Pase el cursor sobre el botón para ver cuántas páginas tienen errores y luego abra cada página en el modo source para ver y corregir el error. Consulte [El botón Publish está deshabilitado por MDX no válido](/es/help-center/publish-button-disabled-invalid-mdx) para más detalles.
+
 <Note>
   Su sitio se actualiza después de que Mintlify compile y despliegue sus cambios. Esto suele tardar entre 30 segundos y unos minutos. Consulte el estado del despliegue en su [dashboard](https://app.mintlify.com).
 </Note>

diff --git a/es/help-center/publish-button-disabled-invalid-mdx.mdx b/es/help-center/publish-button-disabled-invalid-mdx.mdx
@@ -0,0 +1,25 @@
+---
+title: "El botón Publish está deshabilitado por MDX no válido"
+description: "Por qué el botón Publish del editor web está deshabilitado con el mensaje “Fix invalid MDX before publishing” y cómo encontrar y corregir el error."
+keywords: ["publish disabled", "fix invalid MDX before publishing", "invalid MDX", "publish button greyed out", "cannot publish", "MDX error", "frontmatter error", "source mode"]
+---
+
+Si el botón **Publish** del editor web está deshabilitado y al pasar el cursor sobre él aparece **Fix invalid MDX before publishing**, al menos una página de tu rama tiene MDX que no se puede analizar. El editor bloquea la publicación hasta que todas las páginas de la rama se analizan correctamente. Esto evita que la sintaxis rota llegue a tu sitio publicado.
+
+El tooltip te indica cuántas páginas tienen errores. Las causas comunes incluyen:
+
+- 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 una comilla sin cerrar.
+
+<div id="fix-the-error">
+  ## Corregir el error
+</div>
+
+1. Abre la página afectada en el editor.
+2. Cambia al modo source con <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows). El modo source resalta el MDX no válido y muestra el error de análisis.
+3. Corrige la sintaxis. Cuando la página se analiza correctamente, el error desaparece y el botón **Publish** vuelve a estar disponible.
+
+Mientras una página tiene MDX no válido o YAML de frontmatter no válido, esas ediciones se mantienen locales para ti. Los compañeros que editan la misma página solo reciben contenido válido, de modo que un error de sintaxis que introduzcas no sobrescribe su trabajo. Consulta [Colaborar en el editor](/es/editor/collaborate) para saber cómo la edición en tiempo real gestiona el contenido no válido.
+
+Para saber qué ocurre cuando publicas, consulta [Publicar cambios](/es/editor/publish).
diff --git a/fr.json b/fr.json
@@ -459,7 +459,8 @@
             "fr/help-center/preview-deployment-not-created-for-fork-branch",
             "fr/help-center/branch-missing-from-editor-branch-list",
             "fr/help-center/style-card-icons-with-custom-css",
-            "fr/help-center/can-i-rename-my-deployment-or-organization"
+            "fr/help-center/can-i-rename-my-deployment-or-organization",
+            "fr/help-center/publish-button-disabled-invalid-mdx"
           ]
         }
       ]

diff --git a/fr/editor/collaborate.mdx b/fr/editor/collaborate.mdx
@@ -77,8 +77,11 @@ Les mentions fonctionnent sur les pages privées pour les membres qui y ont déj
 
 Lorsque plusieurs personnes ouvrent la même page sur la même branch, elles la modifient ensemble. Le curseur et les modifications de chacun sont visibles par tous, avec des avatars dans la barre d'outils.
 
+L'édition en temps réel fonctionne aussi bien en mode visuel qu'en mode source. Vous pouvez modifier le MDX en mode source pendant qu'un collègue travaille en mode visuel sur la même page. Son curseur et sa sélection apparaissent dans votre éditeur, et les vôtres apparaissent dans le sien, y compris dans les champs de titre et de description.
+
 - Les modifications de tous les collaborateurs fusionnent automatiquement. Deux personnes qui modifient la même section ne créent pas de conflit.
 - L'annulation n'affecte que vos propres modifications.
 - Si vous perdez la connexion, vos modifications sont enregistrées localement et synchronisées à la reconnexion.
+- En mode source, le MDX ou le YAML de frontmatter invalide reste local chez vous jusqu'à ce que vous le corrigiez. Vos collègues ne reçoivent que du contenu valide, et un MDX invalide [bloque la publication](/fr/editor/publish#invalid-mdx-blocks-publishing) tant qu'il n'est pas réparé.
 
 Lorsque l'[agent Mintlify](/fr/agent) modifie une page via l'API ou MCP, il apparaît comme n'importe quel autre collaborateur, avec un avatar et un curseur en direct sur sa modification la plus récente. Le curseur disparaît quand l'agent a terminé.
diff --git a/fr/editor/index.mdx b/fr/editor/index.mdx
@@ -55,9 +55,9 @@ L'éditeur se charge par défaut lorsque vous ouvrez votre [dashboard](https://a
 
 **Le mode visuel** affiche votre page au fur et à mesure que vous écrivez. Appuyez sur <kbd>/</kbd> pour ouvrir le menu des composants et en insérer.
 
-**Le mode source** vous donne un accès direct au MDX. Utilisez-le pour contrôler précisément les propriétés des composants et le frontmatter.
+**Le mode source** vous donne un accès direct au MDX. Utilisez-le pour contrôler précisément les propriétés des composants et le frontmatter. Saisissez `<` pour autocompléter les composants : le menu liste les composants documentés avec la description, les props et un exemple de chacun. À l'intérieur d'une balise, le menu suggère les props et les valeurs de ce composant, y compris les liens vers les pages, les chemins d'images et les noms d'icônes. Survolez le nom d'un composant ou d'une prop pour afficher sa documentation dans un popover. Pour ouvrir le popover à la position du curseur, appuyez sur <kbd>Cmd</kbd> + <kbd>.</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>.</kbd> (Windows).
 
-Les deux modes modifient le même fichier. Passez de l'un à l'autre avec <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows).
+Les deux modes modifient le même fichier et prennent en charge la [collaboration en temps réel](/fr/editor/collaborate#real-time-editing). Passez de l'un à l'autre avec <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows).
 
 Pour connaître les composants que vous pouvez insérer, consultez [Composants](/fr/components). Pour la syntaxe MDX, consultez [Mettre en forme le texte](/fr/create/text) et [Mettre en forme le code](/fr/create/code).
 

diff --git a/fr/editor/keyboard-shortcuts.mdx b/fr/editor/keyboard-shortcuts.mdx
@@ -134,6 +134,8 @@ Le mode source utilise CodeMirror. La plupart des raccourcis courants des édite
 | **Gras** (entoure de `**`) | <kbd>Cmd</kbd> + <kbd>B</kbd> | <kbd>Ctrl</kbd> + <kbd>B</kbd> |
 | **Italique** (entoure de `_`) | <kbd>Cmd</kbd> + <kbd>I</kbd> | <kbd>Ctrl</kbd> + <kbd>I</kbd> |
 | **Commenter ou décommenter** | <kbd>Cmd</kbd> + <kbd>/</kbd> | <kbd>Ctrl</kbd> + <kbd>/</kbd> |
+| **Mettre en forme le document** | <kbd>Cmd</kbd> + <kbd>S</kbd> | <kbd>Ctrl</kbd> + <kbd>S</kbd> |
+| **Afficher la documentation du composant** au curseur | <kbd>Cmd</kbd> + <kbd>.</kbd> | <kbd>Ctrl</kbd> + <kbd>.</kbd> |
 | **Tout replier** | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> |
 | **Tout déplier** | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> |
 | **Augmenter le retrait de la ligne** | <kbd>Tab</kbd> | <kbd>Tab</kbd> |

diff --git a/fr/editor/publish.mdx b/fr/editor/publish.mdx
@@ -47,6 +47,14 @@ S'il n'y a aucune modification en attente, l'éditeur désactive les actions de
 
 Une seule publication peut avoir lieu à la fois par branch. Si un collègue publie sur la même branch, attendez la fin de sa publication avant de réessayer.
 
+<div id="invalid-mdx-blocks-publishing">
+
+### Un MDX invalide bloque la publication
+
+</div>
+
+Si une page de votre branch contient du MDX invalide, l'éditeur désactive le bouton **Publish** jusqu'à ce que vous le corrigiez. Survolez le bouton pour voir combien de pages comportent des erreurs, puis ouvrez chaque page en mode source pour voir et corriger l'erreur. Consultez [Bouton Publish désactivé à cause d'un MDX invalide](/fr/help-center/publish-button-disabled-invalid-mdx) pour plus de détails.
+
 <Note>
   Votre site est mis à jour une fois que Mintlify a compilé et déployé vos modifications. Cela prend généralement de 30 secondes à quelques minutes. Consultez l'état du déploiement sur votre [dashboard](https://app.mintlify.com).
 </Note>