> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Colaborar en el editor
> Deje comentarios, proponga cambios como sugerencias y edite junto a sus compañeros en tiempo real en el editor.
Trabaje con su equipo en una página comentándola, sugiriendo cambios o editándola conjuntamente al mismo tiempo.
Todos los [roles](/docs/es/dashboard/roles) pueden comentar, responder y resolver hilos.
Los comentarios le permiten dejar opiniones sobre un texto concreto o sobre una página completa sin editar el contenido.
**Los comentarios nunca llegan a su repositorio.** Existen solo dentro del editor y nunca se incluyen en el sitio publicado ni se hacen commit en Git. Si su branch tiene una pull request abierta, Mintlify añade a su descripción un resumen de los hilos sin resolver, con un enlace a cada comentario. El resumen se actualiza a medida que cambian los hilos.
Para añadir un comentario, resalte un texto y haga clic en el icono **Comment** de la barra de herramientas o presione Cmd + Shift + M (macOS) o Ctrl + Shift + M (Windows).
Para comentar un bloque completo, como un párrafo, un bloque de código, una imagen, una tabla o un componente, pase el cursor sobre el bloque, haga clic en **Block actions** y seleccione **Comment**. También puede colocar el cursor en el bloque sin seleccionar ningún texto y presionar Cmd + Shift + M (macOS) o Ctrl + Shift + M (Windows). Si alguien elimina un bloque que tiene un comentario sin resolver, el hilo se mueve junto al título de la página con una nota que indica que el bloque comentado se eliminó.
Para comentar la página completa en lugar de un texto concreto, use cualquiera de estas dos opciones:
* Pase el cursor sobre el título de la página y haga clic en **Add comment**.
* En el panel de comentarios, haga clic en **New comment**.
Los comentarios de página aparecen junto al título de la página.
Escriba `@` para mencionar a un compañero en un comentario. Debe ser miembro de su organización y haber aceptado su invitación. Cuando menciona a un compañero en un comentario, recibe una notificación por correo electrónico. Gestione qué correos de comentarios y sugerencias recibe desde la página de [Notificaciones](/docs/es/dashboard/notifications) de su dashboard.
Los hilos de comentarios aparecen tanto en el modo visual como en el modo source. En el modo source puede leer, responder y resolver hilos existentes, pero para iniciar un comentario nuevo necesita el modo visual.
Para ver todos los hilos de la página actual:
1. Haga clic en **More options** en la esquina superior derecha de la página.
2. Haga clic en **Comments**.
Reaccione a un comentario para darse por enterado sin responder. Pase el cursor sobre un comentario, haga clic en el botón **Add reaction** y seleccione un emoji. Reaccionar al comentario de otra persona envía una notificación al autor del comentario.
Para reaccionar a un texto de la página, resáltelo, haga clic en **Add reaction** en la barra de herramientas y seleccione un emoji. Mintlify agrega un comentario sobre el texto resaltado con el emoji como contenido. Sus compañeros pueden responderlo, reaccionar a él, resolverlo o eliminarlo como cualquier otro comentario. Reaccionar a un texto requiere el modo visual.
Para editar o eliminar un comentario que ha escrito, haga clic en **More actions** en el comentario. Solo puede editar y eliminar sus propios comentarios. Eliminar el primer comentario de un hilo elimina el hilo completo.
## Menciones en el contenido de la página
Escriba `@` mientras edita una página para abrir el menú de menciones. Las menciones funcionan tanto en el modo visual como en el modo source.
* **Mencione a un compañero** para hacer referencia a él en el contenido de la página. Mintlify le envía un correo electrónico si tiene acceso a la página.
* **Mencione una página** para insertar un enlace a ella. Mintlify usa el título de la página como texto del enlace.
Active o desactive los correos de menciones en páginas con la opción **Page @mention** de la página de [Notificaciones](/docs/es/dashboard/notifications) de su dashboard.
## Sugerencias
Las sugerencias proponen un cambio manteniendo el contenido actual, de modo que un compañero pueda aceptarlas o rechazarlas.
Los editors y admins pueden aceptar o rechazar cualquier sugerencia. Los viewers no.
Para hacer una sugerencia, resalte un texto y haga clic en **Switch to suggesting** en la barra de herramientas o presione Cmd + Shift + E (macOS) o Ctrl + Shift + E (Windows). En el modo de sugerencias aparece una etiqueta **Suggesting** en la barra superior, y sus eliminaciones e inserciones aparecen como texto resaltado en lugar de como ediciones. Los cambios de formato también se convierten en sugerencias, incluidos negrita, cursiva, subrayado, tachado y código en línea. El texto muestra una vista previa del formato propuesto, pero el formato solo se aplica cuando alguien acepta la sugerencia. Haga clic en la etiqueta para volver a editar. Las sugerencias pendientes aparecen junto a la página y en el panel de comentarios.
El modo de sugerencias solo funciona en el modo visual. Mientras el modo de sugerencias está activado, no puede cambiar al modo source. Desactive el modo de sugerencias para editar el MDX directamente.
Los [viewers](/docs/es/dashboard/roles) están siempre en modo de sugerencias. El modo de sugerencias se activa automáticamente cuando un viewer abre el editor, de forma que pueda proponer cambios sin editar el contenido directamente.
Haga clic en una sugerencia resaltada y luego en **Accept suggestion** o **Reject suggestion**. Cualquiera de las dos opciones resuelve el hilo de la sugerencia. Un cambio aceptado pasa a formar parte de su branch actual y se publica la próxima vez que [publique](/docs/es/editor/publish).
## Preguntar al agente de Mintlify
Mencione `@mintlify` en un comentario, una sugerencia o una respuesta para preguntar al [agente del editor](/docs/es/editor/agent) sobre la página actual. El agente se ejecuta en segundo plano con la página, el hilo y la branch como contexto, y luego publica su respuesta en el mismo hilo.
```text theme={null}
@mintlify does this endpoint support pagination?
@mintlify are there any pages that contradict this?
```
El agente funciona en modo de solo lectura cuando responde a comentarios. Puede buscar en su documentación, leer páginas y sus comentarios abiertos, consultar contenido web y cargar skills, pero no puede editar contenido, crear sugerencias ni publicar. Para hacer cambios, abra directamente el [agente del editor](/docs/es/editor/agent).
Las menciones funcionan en páginas privadas para los miembros que ya tienen acceso.
## Edición en tiempo real
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 sobre la misma página. Su cursor y su selección aparecen en su editor, y los suyos aparecen en el de él, incluidos 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 no válido o el YAML de frontmatter no válido permanecen locales hasta que los corrige. Sus compañeros solo reciben contenido válido, y el MDX no válido [bloquea la publicación](/docs/es/editor/publish#invalid-mdx-blocks-publishing) hasta que se repara.
Cuando el [agente de Mintlify](/docs/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.
## Related topics
- [El botón Publish está deshabilitado por MDX no válido](/docs/es/help-center/publish-button-disabled-invalid-mdx.md)
- [Notificaciones](/docs/es/dashboard/notifications.md)
- [Atajos de teclado](/docs/es/editor/keyboard-shortcuts.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.