# Crear y editar páginas (/es/editor/pages)

<!-- agent-signals: reading_time_min: 13 · est_tokens: 4816 · updated: 2026-09-23 -->
Related: [Cómo usar el editor](/es/editor/tutorial.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)

<div id="workspace-and-site">
  ## Workspace y Site [#workspace-y-site]
</div>

La barra lateral del editor tiene dos pestañas: **Workspace** y **Site**.

**Workspace** contiene páginas que no forman parte de su repositorio de Git ni de su sitio publicado. Las páginas del workspace se guardan automáticamente y no tienen paso de publicación.

* **Recents**: Páginas del workspace que ha abierto recientemente.
* **Starred**: Páginas del workspace que ha marcado con estrella. Para marcar una página, abra su menú de opciones y seleccione **Star**. Las estrellas son personales.
* **Personal**: Sus [páginas privadas](#private-pages).
* **Teamspace**: Páginas compartidas con toda su organización. Consulte [Teamspace](#teamspace).
* **Shared with me**: Páginas que sus compañeros [han compartido con usted](#share-a-private-page) directamente.

**Site** contiene su repositorio y las páginas que sus visitantes ven en su sitio publicado.

* **Navigation**: Las páginas y groups de la navegación de su sitio, tal y como se definen en `docs.json`.
* **Files**: Cada archivo de su repositorio que no está en su navegación, incluidas imágenes, vídeos, especificaciones de OpenAPI y `docs.json`.

Recents, starred y shared with me solo aparecen cuando contienen algo.

Arrastre el encabezado de una sección para reordenar las secciones de una pestaña. Haga clic en el encabezado de una sección para contraerla o expandirla. El editor guarda en su cuenta el orden de las secciones y su estado contraído.

Al cambiar de pestaña se reabre la última página que vio en esa pestaña. La barra superior cambia con la pestaña. **Share** aparece solo en **Workspace**. El selector de branch, **Preview** y **Publish** aparecen solo en **Site**.

<div id="create-a-page">
  ## Crear una página [#crear-una-página]
</div>

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 donde la quiere y luego seleccione **New page**.

* Encabezado de la sección **Navigation**: Añade una página nueva al final de su navegación.
* Un group u otro elemento de navegación: Añade una página nueva dentro de ese elemento.
* Encabezado de la sección **Files** o una carpeta en **Files**: Crea un archivo que no está en su navegación.

El botón **New page** de la parte inferior de la pestaña **Site** también añade una página al final de su navegación.

<Tip>
  Para añadir a su navegación una página que ya existe en su repositorio, 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 y seleccione **Add existing page**.
</Tip>

Los mismos menús crean elementos de navegación como groups, tabs, anchors, dropdowns, versions, languages y products. Para más información sobre cada elemento, consulte [Navegación](/es/organize/navigation).

<div id="edit-page-settings">
  ## Editar la configuración de la página [#editar-la-configuración-de-la-página]
</div>

Establezca el título, la descripción y el icono de una página directamente en la parte superior de la página. Pase el cursor por encima del título y haga clic en **Add icon** para elegir un icono o un emoji. Cuando hay una página con icono abierta, la pestaña de su navegador muestra ese icono.

Para otros ajustes, abra el menú de opciones de la página en la barra lateral o haga clic en <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 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **More options** en la esquina superior derecha de la página y seleccione **Page settings**. El panel **Page settings** agrupa los ajustes en secciones:

* **URL**: La ruta de la página y la URL de redirección. Cambiar la ruta mueve el archivo.
* **Navigation**: Título en la barra lateral, etiqueta, modo y si la página está oculta.
* **SEO & sharing**: Imagen de Open Graph y keywords.

Groups, tabs y otros elementos de navegación tienen sus propios paneles de configuración, como **Group settings** y **Tab settings**. Ábralos desde el menú de opciones del elemento. Consulte [Páginas](/es/organize/pages) para más información sobre ajustes concretos.

<div id="add-media">
  ## Añadir archivos multimedia [#añadir-archivos-multimedia]
</div>

Escriba <kbd>/image</kbd> o <kbd>/video</kbd> para subir un archivo o elegir uno que ya esté en su repositorio. También puede arrastrar archivos desde su equipo hasta la página, o arrastrar una imagen o un vídeo desde la sección **Files** hasta la página.

* Los archivos subidos se guardan en sus carpetas `images/`, `videos/` y `files/` y se incluyen en el commit de su próxima publicación. Antes de insertar un archivo subido, puede editar su ruta.
* Puede subir imágenes PNG, JPG, GIF, WebP, AVIF, ICO y BMP, vídeos MP4, WebM y MOV, y archivos PDF. Los archivos SVG no pueden subirse en el editor.
* Cada archivo puede tener hasta 20 MB.
* Para servir una imagen distinta en modo oscuro, seleccione la imagen, haga clic en **Edit Image** y establezca **Dark mode image**.
* Escriba <kbd>/embed</kbd> para añadir un embed. En la pestaña **Video link**, pegue una URL de YouTube, Loom o Vimeo, o un enlace directo a un archivo de vídeo. En la pestaña **Embed code**, pegue un iframe u otro fragmento de embed.

Para dar formato a las imágenes y usar el componente Frame, consulte [Imágenes e incrustaciones](/es/create/image-embeds).

<div id="organize-navigation">
  ## Organizar la navegación [#organizar-la-navegación]
</div>

Arrastre elementos en **Navigation** para reordenarlos o anidarlos. El editor escribe sus cambios en `docs.json` cuando publica.

<Note>
  Algunos elementos no pueden anidarse dentro de otros. Por ejemplo, las tabs no pueden anidarse dentro de groups. El editor impide las combinaciones no válidas.
</Note>

Para seleccionar varios elementos, haga <kbd>Shift</kbd>-clic para seleccionar un intervalo. Arrastre la selección o haga clic con el botón derecho sobre ella para mover, duplicar o eliminar todos los elementos seleccionados a la vez. Presione <kbd>Esc</kbd> para deshacer la selección.

Para cambiar un group u otro elemento a un tipo distinto, abra su menú de opciones y seleccione **Convert to**.

Los elementos de navegación global, como los anchors y las tabs que aparecen en todas las secciones de su sitio, no están en el árbol de la barra lateral. Para gestionarlos, haga clic en **Site settings** en la parte inferior de la pestaña **Site** y luego vaya a **Navigation**.

<div id="add-and-remove-pages-from-your-navigation">
  ### Añadir y quitar páginas de su navegación [#añadir-y-quitar-páginas-de-su-navegación]
</div>

Arrastre una página desde **Files** a **Navigation** para añadirla en esa posición. Arrastre una carpeta para añadirla como group. También puede seleccionar **Move to navigation** desde el menú de opciones de un archivo.

Para quitar una página o un group de su navegación sin eliminar sus archivos, arrástrelos desde **Navigation** a **Files** o seleccione **Move to files** desde su menú de opciones. Aparece un aviso de deshacer después del movimiento.

<div id="files">
  ## Files [#files]
</div>

Haga clic en un archivo en **Files** para abrirlo.

* Las imágenes se abren en una vista previa. Haga clic en la imagen para ampliarla.
* Los vídeos se reproducen en el editor.
* `docs.json` se abre en el modo source.
* Los archivos de texto y de código, como YAML, JSON y CSS, se abren en el editor de source.
* Otros archivos, como fuentes y comprimidos, no se pueden previsualizar en el editor.

Para subir archivos, arrástrelos desde su equipo hasta la sección **Files**.

<div id="move-a-page">
  ## Mover una página [#mover-una-página]
</div>

Para mover una página a otra carpeta, abra su menú de opciones y seleccione **Move to** o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (Windows) con la página abierta.

Puede abrir el menú de opciones de una página desde:

* <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 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **More options** en la esquina superior derecha de una página abierta.
* El menú <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 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> junto a una página en la barra lateral.
* Haciendo clic con el botón derecho sobre una página en la barra lateral.

En el selector, busque para filtrar carpetas, expanda carpetas para ver destinos anidados y seleccione una carpeta para mover la página. La carpeta actual está marcada como **Current** y no puede seleccionarse. Aparece un aviso con **Revert** después del movimiento.

Mover una página del sitio mueve su archivo a la nueva carpeta. Los editors y admins pueden mover páginas del sitio. Puede mover páginas del workspace que gestiona en **Personal** y **Teamspace**, pero no páginas en **Shared with me**.

<div id="delete-a-page">
  ## Eliminar una página [#eliminar-una-página]
</div>

Para eliminar una página, haga clic en <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 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **More options** en la esquina superior derecha de la página y luego haga clic en **Move to trash**. También puede eliminar una página desde su menú de opciones en la barra lateral.

Eliminar una página del sitio elimina tanto el archivo como su entrada de navegación. Aparece un aviso con **Undo** después de eliminarla. Para quitar una página de su navegación sin eliminar su archivo, seleccione **Move to files** en su lugar.

Eliminar una página del workspace es permanente. Para las páginas del workspace, el menú **More options** muestra **Delete page**.

Los editors y admins pueden eliminar páginas del sitio.

<div id="version-history">
  ## Historial de versiones [#historial-de-versiones]
</div>

El historial de versiones le permite comparar una página con versiones guardadas anteriores y restaurar una. No está disponible para `docs.json`.

El editor registra una entrada nueva siempre que el contenido difiere de la última versión registrada. El historial de versiones está limitado a la branch actual. Solo está disponible el historial de la branch actual.

1. Haga clic en <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 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **More options** en la esquina superior derecha de la página y luego en **Version history**.
2. Seleccione una versión. El editor muestra en qué se diferencia la página actual de esa versión.
3. Para restaurarla, haga clic en **Restore this version** y luego confirme.

Para salir de la comparación, haga clic en **Exit comparison** o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> (Windows).

Cualquiera puede comparar versiones. Los editors y admins pueden restaurar versiones de páginas del sitio. Para las páginas del workspace, necesita el rol **Editor** o **Publisher** en la página para restaurar una versión.

Restaurar una versión reemplaza el contenido actual de la página. Cuando restaura una página del sitio, solo se restaura en su branch actual. Cuando restaura una página del workspace, se restaura en todas las branches.

<div id="private-pages">
  ## Páginas privadas [#páginas-privadas]
</div>

Las páginas privadas son borradores que viven en la sección **Personal** de la pestaña **Workspace**. Son privadas para usted, no se hacen commit en su repositorio y nunca aparecen en su sitio publicado a menos que las mueva a su sitio.

Para crear una página o carpeta privada, 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 del encabezado de la sección **Personal** y luego seleccione **New page** o **New folder**. El botón **New page** de la parte inferior de la pestaña **Workspace** también crea una página privada.

Para establecer un icono o un emoji en una carpeta del workspace, abra su menú de opciones y seleccione **Change icon**. Elija un icono en la pestaña **Icons** o un emoji en la pestaña **Emojis**, o seleccione **Remove** para quitarlo.

<div id="share-a-private-page">
  ### Compartir una página privada [#compartir-una-página-privada]
</div>

Para compartir una página privada, ábrala y haga clic en **Share** en la barra superior. Para compartir una carpeta, abra su menú de opciones en la barra lateral y seleccione **Share**. Busque compañeros y elija un rol para cada uno:

* **Publisher**: Editar, revisar y publicar.
* **Editor**: Crear y editar contenido.
* **Viewer**: Solo ver contenido.

En el acceso general, elija **Only people invited** o **Everyone at** su organización. Solo los Publishers pueden cambiar quién tiene acceso.

Las páginas compartidas con usted aparecen en **Shared with me**. Para quitar una página de su barra lateral, abra su menú de opciones y seleccione **Leave**.

<div id="teamspace">
  ## Teamspace [#teamspace]
</div>

Las páginas de teamspace están disponibles para toda su organización. Al igual que las páginas privadas, no se hacen commit en su repositorio. El acceso sigue su [rol](/es/dashboard/roles). Los editors y admins pueden editar y gestionar las páginas de teamspace, y los viewers pueden leerlas. Como todo el mundo ya tiene acceso, no puede compartir páginas individuales del teamspace.

Para crear una página o carpeta de teamspace, 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 del encabezado de la sección **Teamspace** y luego seleccione **New page** o **New folder**.

Para mover una página privada al teamspace, arrástrela desde **Personal** hasta **Teamspace** o abra su menú de opciones, seleccione **Move to** y elija **Teamspace**. Puede mover páginas, pero no carpetas.

<div id="move-a-page-to-your-site">
  ## Mover una página a su sitio [#mover-una-página-a-su-sitio]
</div>

Para publicar una página personal o de teamspace, abra su menú de opciones en la barra lateral y seleccione **Move to site**. La página se mueve a su navegación, y la barra lateral cambia a **Site** y la resalta. Mover una carpeta la añade a su navegación como group, con todas sus páginas y su icono.

<Warning>
  Mover páginas entre secciones es un cambio de un solo sentido. No puede mover una página desde **Teamspace** de vuelta a **Personal** ni desde **Site** de vuelta a **Workspace**.
</Warning>