# Cómo usar el editor (/es/editor/tutorial)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 1335 · updated: 2026-09-23 -->
Related: [Crear y editar páginas](/es/editor/pages.md), [Publicar cambios](/es/editor/publish.md), [Revisar cambios](/es/editor/review.md), [Colaborar en el editor](/es/editor/collaborate.md), [Preguntar al agente](/es/editor/agent.md), [Configuración del editor para IA y publicación](/es/editor/settings.md)

Este tutorial le guía a través de una actualización completa de contenido usando el editor. Creará una branch, hará un cambio, compartirá una vista previa para su revisión y publicará sus cambios.

<Steps>
  <Step title="Crear una branch">
    Una branch es una copia temporal de su contenido. Es donde realiza sus cambios sin afectar a su sitio publicado. Puede hacer merge de una branch en su sitio publicado o descartarla de forma segura si decide no aplicar los cambios.

    Trabajar en una branch mantiene sus ediciones separadas de su sitio publicado hasta que esté listo para compartir el contenido con sus usuarios.

    1. En la barra de herramientas del editor, haga clic en el nombre de la branch (normalmente `main`, con una insignia **Live**). Si no lo ve, [muestre el selector de branch](/es/editor/publish#show-the-branch-selector).
       <Frame>
         <img src="/_assets/bf51e2362f1e2e0da4fd2b42ec73ef0dfe28e2dac4c23284d0d724f52eecd6b7" alt="Nombre de la branch destacado en la barra de herramientas del editor." className="block dark:hidden" />

         <img src="/_assets/0ba261353886d412e1f0ab56a000d7751e1593e83b19c4328acdb3ba495c5e27" alt="Nombre de la branch destacado en la barra de herramientas del editor." className="hidden dark:block" />
       </Frame>
    2. En **Find a branch**, escriba un título que describa su cambio, como `Update quickstart`.
    3. Haga clic en **New branch**.

    El editor cambia a su nueva branch. Cualquier cambio que realice está solo en la branch, y se hace commit en la branch automáticamente mientras trabaja. Solo aparecerán en su sitio publicado si completa el proceso de publicación.
  </Step>

  <Step title="Realizar los cambios">
    Edite una página existente o cree una nueva.

    **Para editar una página**: Haga clic en el nombre de la página en la barra lateral de navegación para abrirla. Escriba directamente en el editor para añadir contenido. Presione <kbd>/</kbd> para insertar componentes, imágenes u otro contenido.

    **Para crear una página**: Haga clic en el botón <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12.001 5.00003V19.002&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M19.002 12.002L4.99998 12.002&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> más junto al grupo de navegación donde quiere añadir la página y luego haga clic en **New page**. Escriba un título para la página. El editor nombra el archivo con el título.

    <Frame>
      <img src="/_assets/848f57ebc752f3850dc57e934252bc9b77001b05f33f941ae611d460b77b0850" alt="El menú de añadir página abierto junto a un grupo en el editor." className="block dark:hidden" />

      <img src="/_assets/aa56585168d2faea354b3e46c96fef0e6974c68f4e17d475d1ddab3162fd867a" alt="El menú de añadir página abierto junto a un grupo en el editor." className="hidden dark:block" />
    </Frame>
  </Step>

  <Step title="Publicar su branch">
    Cuando edita una branch por primera vez, el editor le abre una pull request. Una pull request es una propuesta para hacer merge de sus cambios en la branch que compila su sitio publicado. Sus cambios solo se publican después de que la pull request se haya fusionado.

    Cuando esté listo para la revisión, solicítela desde el menú de publicación.

    1. Haga clic en **Publish** en la barra de herramientas para abrir el menú de publicación.
    2. Opcionalmente, haga clic en cualquier archivo modificado de la lista para ver y comparar sus ediciones con la versión publicada.
    3. Haga clic en **Request review**.

    Se compila un [despliegue de vista previa](/es/editor/review#preview-deployments) para su pull request: un enlace temporal donde sus cambios se representan exactamente como se verían en su sitio publicado. Encuentre la URL en el comentario de la pull request del bot de Mintlify y compártala con sus revisores.
  </Step>

  <Step title="Obtener la aprobación de su pull request">
    Comparta la pull request con su equipo. Para abrirla, haga clic en **View request** en el menú de publicación. Los revisores pueden abrir la pull request en GitHub, GitLab o Bitbucket para dejar comentarios, solicitar cambios o aprobarla.

    Si un revisor solicita cambios, realice las ediciones en el editor en la misma branch. Sus actualizaciones se hacen commit en la pull request existente automáticamente. No necesita crear una nueva.

    Cuando todos los revisores requeridos hayan aprobado, la pull request está lista para hacer merge.
  </Step>

  <Step title="Hacer merge y publicar">
    Con la pull request aprobada, haga clic en **Publish** en la barra de herramientas para reabrir el menú de publicación. El menú ahora muestra el estado de la pull request y una opción para hacer merge.

    Haga clic en **Merge and publish**. Si Mintlify aloja su repositorio y no se requieren aprobaciones, el botón se llama **Publish**. El editor hace merge de la pull request y le devuelve a su deployment branch. Mintlify compila y despliega sus cambios. Su sitio publicado se actualiza en unos 30 segundos a unos pocos minutos.
  </Step>
</Steps>