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

<!-- agent-signals: reading_time_min: 10 · est_tokens: 4000 · updated: 2026-07-30 -->
Related: [Cómo usar el editor](/es/editor/tutorial.md), [Conceptos básicos de Git para el editor](/es/editor/git-essentials.md), [Agregar contenido multimedia](/es/editor/media.md), [Organizar la navegación](/es/editor/navigation.md), [Vista previa en vivo](/es/editor/live-preview.md), [Branches y publicación](/es/editor/branching-and-publishing.md)

<div id="navigate-files">
  ## Navegar por archivos [#navegar-por-archivos]
</div>

El panel izquierdo tiene dos vistas: **Navigation** y **Files**.

**Navigation** muestra la estructura de su barra lateral tal como la ven los visitantes. Haga clic en una página para abrirla.

**Files** muestra el árbol de archivos completo de su repositorio, incluidos los archivos que no están en su navegación. Haga clic en cualquier archivo para abrirlo.

Para alternar entre vistas, haga clic en el icono <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;M2.5 20V8.87695C2.5 7.58945 2.5 6.9457 2.78533 6.47048C2.9541 6.18939 3.18939 5.9541 3.47048 5.78533C3.9457 5.5 4.59449 5.5 5.89206 5.5C6.52339 5.5 6.83906 5.5 7.12612 5.58819C7.31759 5.64702 7.49914 5.73428 7.66469 5.84705C7.91289 6.01611 8.10859 6.26074 8.5 6.75C8.89141 7.23926 9.08711 7.48389 9.33531 7.65295C9.50086 7.76572 9.68241 7.85298 9.87388 7.91181C10.1609 8 10.4742 8 11.1008 8H15C16.4045 8 17.1067 8 17.6111 8.33706C17.8295 8.48298 18.017 8.67048 18.1629 8.88886C18.5 9.39331 18.5 10.0955 18.5 11.5&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M4.42028 14.0144L3.63368 16.0144C2.65618 18.4998 2.16743 19.7425 2.7524 20.6213C3.33737 21.5 4.65337 21.5 7.28537 21.5H15.1903C16.4249 21.5 17.0422 21.5 17.5295 21.1795C18.0169 20.859 18.2702 20.2865 18.7769 19.1415L19.6618 17.1415C20.7866 14.5992 21.349 13.3281 20.7679 12.4141C20.1868 11.5 18.8163 11.5 16.0752 11.5H8.07196C6.78232 11.5 6.1375 11.5 5.63811 11.8439C5.13872 12.1877 4.89924 12.7966 4.42028 14.0144Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M11.5 4.51456C12.4151 3.28409 13.6662 2.55594 15.5125 2.50161C16.1155 2.48386 16.7152 2.61395 17.2682 2.85544C18.5748 3.42601 19.4185 4.15644 20 5.5L21.5 3&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de archivo o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> (Windows). Haga clic en el icono de búsqueda o presione <kbd>Cmd</kbd> + <kbd>K</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>K</kbd> (Windows) para buscar por nombre de archivo o contenido de la página.

<div id="manage-files-and-folders">
  ## Administrar archivos y carpetas [#administrar-archivos-y-carpetas]
</div>

Use la vista Files para organizar su contenido:

* **Crear una carpeta**: 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;M13 21H12C7.28595 21 4.92893 21 3.46447 19.5355C2 18.0711 2 15.714 2 11V7.94427C2 6.1278 2 5.21956 2.38032 4.53806C2.65142 4.05227 3.05227 3.65142 3.53806 3.38032C4.21956 3 5.1278 3 6.94427 3C8.10802 3 8.6899 3 9.19926 3.19101C10.3622 3.62712 10.8418 4.68358 11.3666 5.73313L12 7M8 7H16.75C18.8567 7 19.91 7 20.6667 7.50559C20.9943 7.72447 21.2755 8.00572 21.4944 8.33329C21.9796 9.05942 21.9992 10.0588 22 12&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M18 13V21M22 17H14&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de nueva carpeta en la parte superior del árbol de archivos, o haga clic con el botón derecho en una carpeta existente y seleccione **New folder**.
* **Renombrar un archivo o carpeta**: Haga clic con el botón derecho sobre el elemento y seleccione **Rename**.
* **Abrir archivos no listados**: Haga clic en cualquier archivo del árbol para abrirlo, incluso si no está incluido en su navegación.

Los archivos que no están en su navegación quedan como no listados. Existen en su repositorio pero no aparecerán en la barra lateral publicada.

<div id="create-new-pages">
  ## Crear páginas nuevas [#crear-páginas-nuevas]
</div>

<div id="add-a-page-to-navigation">
  ### Añadir una página a la navegación [#añadir-una-página-a-la-navegación]
</div>

1. 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>" /> de más en el elemento de navegación donde quiere añadir una página.
2. Haga clic en **Add a page**.
3. Introduzca un nombre de archivo. El editor añade la extensión `.mdx` automáticamente.

<div id="create-an-unlisted-page">
  ### Crear una página no listada [#crear-una-página-no-listada]
</div>

Las páginas no listadas existen en su repositorio pero no aparecen en la navegación. Son útiles para contenido en borrador, fragmentos reutilizables o páginas que planea añadir a la navegación más adelante.

Haga clic con el botón derecho en cualquier carpeta de la vista Files y seleccione **New file**. Introduzca un nombre de archivo y el editor crea la página sin añadirla a la navegación. Puede añadirla a la navegación más tarde desde la pestaña **Navigation**.

<div id="edit-content">
  ## Editar contenido [#editar-contenido]
</div>

Alterne entre el modo visual y source usando el conmutador de modo en la barra de herramientas debajo de la barra superior. Haga clic en el icono <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;M2 8C2 8 6.47715 3 12 3C17.5228 3 22 8 22 8&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21.544 13.045C21.848 13.4713 22 13.6845 22 14C22 14.3155 21.848 14.5287 21.544 14.955C20.1779 16.8706 16.6892 21 12 21C7.31078 21 3.8221 16.8706 2.45604 14.955C2.15201 14.5287 2 14.3155 2 14C2 13.6845 2.15201 13.4713 2.45604 13.045C3.8221 11.1294 7.31078 7 12 7C16.6892 7 20.1779 11.1294 21.544 13.045Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M15 14C15 12.3431 13.6569 11 12 11C10.3431 11 9 12.3431 9 14C9 15.6569 10.3431 17 12 17C13.6569 17 15 15.6569 15 14Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de ojo o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> (Windows) para cambiar al modo visual. Haga clic en el icono <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;M16 6.99998L19.0664 9.64296C20.3554 10.7541 21 11.3096 21 12C21 12.6903 20.3555 13.2459 19.0664 14.357L16 17&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M8 6.99998L4.93365 9.64296C3.64455 10.7541 3 11.3096 3 12C3 12.6903 3.64455 13.2459 4.93365 14.357L8 17&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de código o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> (Windows) para cambiar al modo source.

**El modo visual** muestra una vista previa en tiempo real a medida que escribe. Presione <kbd>/</kbd> para abrir el menú de componentes e insertar componentes, imágenes, vídeos y otro contenido. También puede arrastrar y soltar archivos multimedia directamente sobre la página desde su ordenador o desde el árbol de navegación. Otros atajos:

* **Insertar un enlace**: Seleccione texto y presione <kbd>Cmd</kbd> + <kbd>K</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>K</kbd> (Windows), o arrastre una página desde el árbol de navegación al editor para crear un enlace con el título de la página.
* **Enlazar a otra página**: Haga clic con el botón derecho en una página del árbol de navegación, haga clic en **Copy link** y luego pegue el enlace en su contenido. El editor reconoce los enlaces internos a otras páginas y los convierte.
* **Insertar medios de su proyecto**: Arrastre una imagen o vídeo desde el árbol de navegación a la página para incrustarlos en línea. Los formatos admitidos incluyen PNG, JPG, JPEG, GIF, WebP, SVG, MP4 y WebM.
* **Insertar un emoji**: Escriba <kbd>:</kbd> seguido de una palabra clave para abrir el selector de emojis.
* **Editar una tabla**: Cuando su cursor está dentro de una tabla, use la barra de herramientas flotante para añadir o eliminar filas y columnas, o combinar celdas.

**El modo source** le da acceso directo al código MDX. Úselo para tener un control preciso sobre las propiedades de los componentes y el frontmatter.

Para una lista completa de componentes, consulte [Components](/es/components). Para la sintaxis MDX, consulte [Format text](/es/create/text) y [Format code](/es/create/code).

<div id="diff-view">
  ### Vista de diff [#vista-de-diff]
</div>

Para comparar su página actual con la última versión publicada, 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;M5.9925 12V18M9 14.9925L3 14.9925&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M3 22H9&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M13 22C16.7712 22 18.6569 22 19.8284 20.8284C21 19.6569 21 17.7712 21 14V10.6569C21 9.83935 21 9.4306 20.8478 9.06306C20.6955 8.69552 20.4065 8.40649 19.8284 7.82843L15.0919 3.09188C14.593 2.593 14.3436 2.34355 14.0345 2.19575C13.9702 2.165 13.9044 2.13772 13.8372 2.11401C13.5141 2 13.1614 2 12.4558 2C9.21082 2 7.58831 2 6.48933 2.88607C6.26732 3.06508 6.06508 3.26731 5.88608 3.48933C5.14374 4.41003 5.02332 5.69818 5.00378 8M14 2.5V3C14 5.82843 14 7.24264 14.8787 8.12132C15.7574 9 17.1716 9 20 9H20.5&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **View diff** en la barra de herramientas, o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> (Windows). En modo visual se muestra un diff visual. En modo source se muestra un diff de texto. Haga clic en **Exit diff** o presione el atajo nuevamente para volver a la edición.

También puede abrir un diff desde el menú de publicación. Haga clic en **Publish** y luego en cualquier archivo modificado de la lista.

<div id="block-actions">
  ### Acciones de bloque [#acciones-de-bloque]
</div>

En modo visual, pase el cursor sobre cualquier bloque para mostrar un controlador de arrastre a la izquierda. Haga clic en el controlador para abrir un menú contextual con acciones para ese bloque:

* **Turn into**: Convierte el bloque en otro tipo: texto, encabezados, cita en bloque o lista.
* **Duplicate**: Inserta una copia del bloque inmediatamente después.
* **Delete**: Elimina el bloque.

<Frame>
  <img src="/_assets/f56befec22440dc57cfe1f83a495641392d6ca6da28de7f7f317f2d651f2ffd1" alt="El menú de acciones de bloque en modo visual." className="block dark:hidden" />

  <img src="/_assets/8a7c9828694aa13f66e847c14aa6853faa0484180262c30dc9e22725327f2bdd" alt="El menú de acciones de bloque en modo visual." className="hidden dark:block" />
</Frame>

<div id="table-of-contents">
  ### Índice de contenido [#índice-de-contenido]
</div>

En modo visual, el editor muestra un minimapa en el lado derecho de la página que refleja la estructura de encabezados de su documento. Pase el cursor sobre el minimapa para expandirlo en un índice de contenido completo. Haga clic en cualquier encabezado para desplazarse a esa sección.

<div id="code-block-options">
  ### Opciones de los bloques de código [#opciones-de-los-bloques-de-código]
</div>

Al editar un bloque de código en modo visual, puede:

* **Resaltar o enfocar líneas**: Seleccione texto dentro del bloque de código y luego use la barra de herramientas que aparece para marcar líneas como resaltadas o enfocadas. Resaltar enfatiza visualmente las líneas. Enfocar líneas atenúa todo lo demás.
* **Marcar líneas de diff**: Seleccione líneas y use la barra de herramientas para marcarlas como adiciones (`+`) o eliminaciones (`-`).
* **Wrap**: Alterna el ajuste de línea en la configuración del bloque de código.
* **Expandable**: Hace que el bloque de código sea contraíble para que los lectores puedan expandirlo cuando lo deseen.

<div id="manage-pages">
  ## Administrar páginas [#administrar-páginas]
</div>

* **Mover**: Arrastre y suelte las páginas para reordenarlas en la navegación.
* **Renombrar**: Haga clic con el botón derecho en una página y seleccione **Rename**.
* **Duplicar**: Haga clic con el botón derecho en una página y seleccione **Duplicate**.
* **Eliminar**: Haga clic con el botón derecho en una página y seleccione **Delete**. El editor quita la página de la navegación automáticamente.

<div id="pages-deleted-via-git">
  ### Páginas eliminadas mediante Git [#páginas-eliminadas-mediante-git]
</div>

Si un compañero de equipo elimina una página a través de Git mientras la tiene abierta, el editor entra en modo de solo lectura y muestra una barra de aviso. El editor conserva su contenido para que pueda copiarlo antes de salir de la página.

<div id="configure-pages">
  ## Configurar páginas [#configurar-páginas]
</div>

Pase el cursor sobre una página y haga clic en el icono de engranaje, o haga clic con el botón derecho y seleccione **Settings**, para configurar:

* **Title**, **Slug** y **Sidebar title**: Controlan cómo aparece la página en la navegación y su URL.
* **Description** y **Keywords**: Mejoran la búsqueda y el SEO.
* **Layout**: Elija entre estándar, ancho, centrado o personalizado.

Para más detalles sobre cada ajuste, consulte [Pages](/es/organize/pages).

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

<div id="images-and-videos">
  ### Imágenes y vídeos [#imágenes-y-vídeos]
</div>

Escriba <kbd>/image</kbd> para subir una nueva imagen o seleccionar una existente de su repositorio. Escriba <kbd>/video</kbd> para subir o seleccionar un vídeo.

También puede arrastrar y soltar archivos desde su ordenador directamente sobre una página. En modo visual, el archivo se inserta en línea. En modo source, el editor inserta la ruta del archivo en la posición del cursor. Las imágenes se guardan en su carpeta `images/` y los vídeos en `videos/`.

Para reutilizar medios que ya existen en su proyecto, arrastre un archivo de imagen o vídeo desde el árbol de navegación a la página. El editor incrusta el activo en línea.

<div id="light-and-dark-image-variants">
  ### Variantes de imagen claras y oscuras [#variantes-de-imagen-claras-y-oscuras]
</div>

Después de insertar una imagen en modo visual, pase el cursor sobre ella para mostrar la barra de herramientas de imagen. Use **Light/dark variants** para subir imágenes separadas para modo claro y oscuro.

<div id="embed-external-media">
  ### Incrustar medios externos [#incrustar-medios-externos]
</div>

Escriba <kbd>/embed</kbd> y pegue una URL de YouTube, Loom o Vimeo. El editor detecta el proveedor y genera el iframe. Buscar `youtube`, `yt`, `loom` o `vimeo` en el menú de barra inclinada también muestra el comando **Embed**.

Para otras incrustaciones, escriba <kbd>/embed</kbd> y active **Manual embed** para escribir HTML personalizado.

Para más información sobre el formato de imágenes y el uso del componente Frame, consulte [Images and embeds](/es/create/image-embeds).
