Citas en bloque de Markdown: citas, varios párrafos y listas

Una cita en bloque de Markdown empieza con > seguido de un espacio. Pon el marcador al principio de cada línea citada para que el código fuente resulte fácil de leer y editar.

> La guía de instalación revisada está lista para su revisión.

El resultado es un párrafo citado, no un bloque de código. Su borde, sangría y color dependen del tema de la página o del documento. El texto de la cita sigue siendo Markdown normal, por lo que puede contener énfasis, enlaces, listas y otras estructuras del documento.

Usa el visor de Markdown para probar los ejemplos y exporta después el documento con el conversor de Markdown a Word cuando necesites una copia editable para revisión.

Cita un párrafo repartido en varias líneas del archivo fuente

Para una cita más larga, repite el marcador:

> La guía de instalación revisada está lista para su revisión.
> Comprueba los requisitos previos antes de aprobar la publicación.

Estas dos líneas del archivo fuente forman un solo párrafo en la vista previa de este sitio. Un salto en el código fuente no obliga necesariamente a mostrar un salto de línea. Si el texto debe mantenerse en dos líneas, añade un salto explícito:

> Revisión de la documentación\
> Asignada a la persona responsable de la versión

La barra invertida se coloca antes del salto de línea; la siguiente línea sigue empezando con el marcador de cita. Consulta saltos de línea en Markdown para distinguir entre saltos forzados y saltos de párrafo.

Incluye varios párrafos en una cita

Pon un marcador de cita en la línea que, de otro modo, quedaría vacía entre los párrafos:

> El primer borrador describe el proceso de instalación.
>
> El segundo añade pasos de resolución de problemas y ejemplos.

Así se crea una cita en bloque con dos párrafos. Mantener > en la separación hace visible la agrupación prevista, especialmente cuando alguien edite el fragmento más adelante.

Para retomar tu propio texto, deja una línea en blanco y continúa sin el marcador:

> La revisión solicitó una sección de instalación más breve.

Trasladamos las notas de configuración detalladas a un apéndice.

Evita quitar > de una línea de continuación sin añadir una línea en blanco. Algunos analizadores de Markdown lo interpretan como una continuación implícita del párrafo citado. La especificación de citas en bloque de CommonMark describe este comportamiento. Los marcadores explícitos y una línea vacía clara facilitan el mantenimiento entre colaboradores.

Añade énfasis, enlaces y atribución

El contenido de una cita puede usar el formato en línea habitual:

> **Nota de revisión:** Los pasos de migración necesitan un ejemplo funcional.
> Consulta la [lista de comprobación de la versión](https://example.com/checklist).
>
> Comentarios de la revisión de documentación, septiembre de 2026.

Markdown no asigna una función especial de referencia bibliográfica a la última línea. Es contenido de párrafo normal dentro de la cita. Incluye la fuente, el autor y el enlace cuando sean necesarios, y comprueba los permisos antes de reproducir un fragmento ajeno.

Una cita en bloque tampoco añade comillas literales. Escríbelas tú si el documento final las requiere. Para una cita breve integrada en tu propia frase, las comillas normales pueden bastar sin crear un bloque separado.

Anida una cita o incluye una lista

Usa otro nivel de > para el material citado dentro de la cita exterior:

> La persona revisora resumió la solicitud anterior:
>
> > Añade un ejemplo completo del archivo de configuración.
>
> El borrador actualizado ya incluye ese ejemplo.

Limita los niveles de anidación en un informe. Las citas muy anidadas reducen el ancho disponible para el texto, lo que puede dificultar la lectura de las maquetaciones en PDF y Word.

Una lista dentro de una cita conserva el marcador en cada línea:

> La revisión identificó dos cambios:
>
> - Explicar los permisos necesarios.
> - Añadir una sección de resolución de problemas.

Para la estructura opuesta, una cita dentro de una lista, aplica sangría bajo el texto del elemento:

- Comentarios sobre la documentación

  > Añade una sección de resolución de problemas antes de publicar.
- Lista de comprobación de la versión

Si la cita aparece fuera del elemento, compara su sangría con los ejemplos de la guía de sangría en Markdown.

Las alertas de GitHub necesitan compatibilidad en el destino

GitHub admite alertas especiales basadas en la sintaxis de citas, incluida esta forma:

> [!NOTE]
> Haz una copia de seguridad de la configuración antes de cambiarla.

GitHub documenta los tipos admitidos en su referencia de alertas. Los colores e iconos de las alertas son funciones de la plataforma, no propiedades de todas las citas Markdown.

El renderizador de este sitio no aplica el estilo de alertas de GitHub. El ejemplo sigue siendo una cita en bloque con la etiqueta [!NOTE] visible. Para un documento que deba leerse bien en distintos destinos, usa una etiqueta explícita en negrita:

> **Nota:** Haz una copia de seguridad de la configuración antes de cambiarla.

Así se conserva un significado comprensible sin una extensión especial de alertas. El mismo enfoque sirve para una advertencia, una decisión de revisión o una nota editorial.

Soluciona los problemas de las citas antes de exportar

Si > aparece literalmente, comprueba si el ejemplo está entre acentos graves, dentro de un bloque de código delimitado o en un bloque de código con sangría. Esos contextos sirven para mostrar texto fuente. Una barra invertida antes del marcador también lo escapa.

Si se incluye demasiado texto en la cita, añade una línea en blanco antes del párrafo que deba continuar fuera de ella. Si el contenido anidado es difícil de seguir, reduce la anidación y añade la atribución como párrafo normal.

Por último, abre el DOCX exportado y revisa las citas largas y las listas citadas. El borde izquierdo del navegador y el estilo de párrafo de un documento Word pueden diferir. Usa la herramienta de Markdown a HTML para inspeccionar la estructura intermedia cuando necesites distinguir un problema de formato del código fuente de uno del estilo de exportación.