Sintaxis de Citas

Las citas se utilizan para resaltar texto citado o enfatizar información importante. En Markdown, usa el símbolo > para crear bloques de cita.

Sintaxis Básica de Citas

Cita de una sola línea

Usa el símbolo > al inicio de una línea para crear una cita:

markdown

> Esto es una cita.

Visualización Renderizada:

Esto es una cita.

Cita de varias líneas

markdown

> Esta es la primera línea de la cita.
> Esta es la segunda línea de la cita.
> Esta es la tercera línea de la cita.

Visualización Renderizada:

Esta es la primera línea de la cita. Esta es la segunda línea de la cita. Esta es la tercera línea de la cita.

Párrafos en Citas

Incluye varios párrafos en una cita:

markdown

> Este es el primer párrafo de la cita.
>
> Este es el segundo párrafo de la cita.

Visualización Renderizada:

Este es el primer párrafo de la cita.
Este es el segundo párrafo de la cita.

Citas Anidadas

Anidamiento Básico

Usa >> para crear citas anidadas:

markdown

> Esta es la cita de primer nivel.
>
> > Esta es la cita de segundo nivel.
>
> De vuelta al primer nivel de cita.

Visualización Renderizada:

Esta es la cita de primer nivel.
Esta es la cita de segundo nivel.
De vuelta al primer nivel de cita.

Anidamiento de varios niveles

markdown

> Cita nivel 1
> > Cita nivel 2
> > > Cita nivel 3
> > > > Cita nivel 4
> >
> > De vuelta al nivel 2
>
> De vuelta al nivel 1

Visualización Renderizada:

Cita nivel 1
Cita nivel 2
Cita nivel 3
Cita nivel 4
De vuelta al nivel 2
De vuelta al nivel 1

Otros Elementos en Citas

Formato en Citas

markdown

> **Texto en negrita** y *texto en cursiva* funcionan normalmente en las citas.
> 
> Puedes usar `código en línea` y otros formatos.

Visualización Renderizada:

Texto en negrita y texto en cursiva funcionan normalmente en las citas.
Puedes usar código en línea y otros formatos.

Encabezados en Citas

markdown

> ## Encabezado en Cita
> 
> Este es el contenido principal en la cita.
> 
> ### Subencabezado
> 
> Más contenido citado.

Visualización Renderizada:

Encabezado en Cita
Este es el contenido principal en la cita.
Subencabezado
Más contenido citado.

Listas en Citas

markdown

> Lista en cita:
> 
> 1. Primer elemento
> 2. Segundo elemento
> 3. Tercer elemento
> 
> O lista desordenada:
> 
> - Elemento A
> - Elemento B
> - Elemento C

Visualización Renderizada:

Lista en cita:
Primer elemento
Segundo elemento
Tercer elemento
O lista desordenada:
Elemento A
Elemento B
Elemento C

Bloques de Código en Citas

markdown

> Aquí hay un ejemplo de código:
> 
> ```javascript
> function hola() {
>   console.log("¡Hola, Mundo!");
> }
> ```
> 
> Los bloques de código también se muestran correctamente en las citas.

Visualización Renderizada:

Aquí hay un ejemplo de código:
javascript
function hola() {
  console.log("¡Hola, Mundo!");
}
Los bloques de código también se muestran correctamente en las citas.

Enlaces en Citas

markdown

> Consulta la [documentación oficial](https://www.markdownlang.com) para más información.
> 
> También puedes visitar <https://www.markdownlang.com> para un enlace directo.

Visualización Renderizada:

Consulta la documentación oficial para más información.
También puedes visitar https://www.markdownlang.com para un enlace directo.

Escenarios Comunes de Uso

1. Cita Literaria

markdown

> "Markdown es un lenguaje de marcado ligero que permite a las personas escribir documentos en un formato de texto plano fácil de leer y escribir."
> 
> — John Gruber, creador de Markdown

Visualización Renderizada:

"Markdown es un lenguaje de marcado ligero que permite a las personas escribir documentos en un formato de texto plano fácil de leer y escribir."
— John Gruber, creador de Markdown

2. Mensaje de Advertencia

markdown

> ⚠️ **Advertencia**
> 
> Realizar esta acción eliminará todos los datos. Por favor, asegúrate de hacer una copia de seguridad de los archivos importantes.

Visualización Renderizada:

⚠️ Advertencia
Realizar esta acción eliminará todos los datos. Por favor, asegúrate de hacer una copia de seguridad de los archivos importantes.

3. Mensaje de Consejo

markdown

> 💡 **Consejo**
> 
> Usa el atajo `Ctrl+S` para guardar rápidamente el documento.

Visualización Renderizada:

💡 Consejo
Usa el atajo Ctrl+S para guardar rápidamente el documento.

4. Nota Importante

markdown

> 📌 **Nota Importante**
> 
> Antes de comenzar, asegúrate de tener instaladas las siguientes dependencias:
> 
> - Node.js (>= 14.0)
> - npm (>= 6.0)
> - Git

Visualización Renderizada:

📌 Nota Importante
Antes de comenzar, asegúrate de tener instaladas las siguientes dependencias:
Node.js (>= 14.0)
npm (>= 6.0)
Git

Errores Comunes y Soluciones

1. Falta el símbolo >

markdown

❌ Incorrecto:
> Primera línea de la cita
Segunda línea sin símbolo >  ← Esta línea no se incluirá en la cita

✅ Correcto:
> Primera línea de la cita
> Segunda línea correctamente citada

2. Error de Nivel de Anidamiento

markdown

❌ Incorrecto:
> Nivel 1
> > > Saltó directamente al nivel 3  ← Se saltó el nivel 2

✅ Correcto:
> Nivel 1
> > Nivel 2
> > > Nivel 3

3. Manejo de Líneas en Blanco

markdown

❌ Posible problema:
> Primer párrafo

> Segundo párrafo  ← Esto crea dos citas separadas

✅ Cita multipárrafo correcta:
> Primer párrafo
>
> Segundo párrafo

Buenas Prácticas

1. Mantén el Estilo Consistente

markdown

✅ Recomendado: Estilo de cita unificado
> Toda la información importante usa citas
> Mantén el formato consistente

❌ No recomendado: Uso mixto
> A veces usa cita
**A veces usa negrita en su lugar**

2. Usa el Anidamiento de Forma Apropiada

markdown

✅ Recomendado: Anidamiento simple y claro
> Punto principal
> > Argumento de apoyo
> 
> Continúa el punto principal

❌ No recomendado: Anidamiento demasiado profundo
> > > > > Demasiado profundo, difícil de leer

3. Uso Semántico

markdown

✅ Recomendado: Citas con significado
> Esta es información importante de un documento autorizado

❌ No recomendado: Citas decorativas
> Esto es solo texto normal, no necesita formato de cita

Salida HTML

Las citas en Markdown se convierten a HTML:

markdown

> Esto es texto citado

Se convierte en:

html

<blockquote>
  <p>Esto es texto citado</p>
</blockquote>

Citas anidadas:

markdown

> Nivel 1
> > Nivel 2

Se convierte en:

html

<blockquote>
  <p>Nivel 1</p>
  <blockquote>
    <p>Nivel 2</p>
  </blockquote>
</blockquote>

Estilos Personalizados

Algunos procesadores de Markdown soportan estilos personalizados para citas:

Admoniciones estilo GitHub

markdown

> [!NOTE]
> Esta es una nota informativa

> [!WARNING]
> Esta es una nota de advertencia

> [!IMPORTANT]
> Esta es una nota importante

Usando HTML y CSS

markdown

<blockquote style="border-left: 4px solid #3498db; padding-left: 1em; color: #7f8c8d;">
Esta es una cita con estilo personalizado
</blockquote>

Ejemplos Prácticos

Ejemplo en Documentación de API

markdown

## Autenticación de Usuario

La autenticación de usuario es un paso necesario para acceder a la API.

> **Método de Autenticación**
> 
> Nuestra API utiliza Bearer Token para autenticación:
> 
> ```bash
> curl -H "Authorization: Bearer TU_TOKEN" \
>      https://api.example.com/users
> ```

### Ejemplo de Solicitud

Envía una solicitud POST para crear un usuario:

> ```json
> {
>   "name": "John Doe",
>   "email": "john@example.com",
>   "role": "user"
> }
> ```

Notas en Tutoriales

markdown

## Pasos de Instalación

1. Descarga el instalador
2. Ejecuta el instalador

> ⚠️ **Nota**
> 
> Antes de la instalación, asegúrate de:
> - El antivirus está desactivado
> - Ejecutar como administrador
> - El disco del sistema tiene al menos 2GB libres

3. Completa el asistente de instalación

Sintaxis Relacionada

Sintaxis de Énfasis - Formato de texto
Sintaxis de Listas - Listas de elementos
Sintaxis de Código - Formato de código
Sintaxis de Enlaces - Crear enlaces

Práctica

Intenta crear lo siguiente:

Una cita con varios párrafos
Una estructura de cita anidada de tres niveles
Una cita técnica con ejemplo de código
Una cita anidada simulando una conversación

Sintaxis de Citas ​

Sintaxis Básica de Citas ​

Cita de una sola línea ​

Cita de varias líneas ​

Párrafos en Citas ​

Citas Anidadas ​

Anidamiento Básico ​

Anidamiento de varios niveles ​

Otros Elementos en Citas ​

Formato en Citas ​

Encabezados en Citas ​

Encabezado en Cita ​

Subencabezado ​

Listas en Citas ​

Bloques de Código en Citas ​

Enlaces en Citas ​

Escenarios Comunes de Uso ​

1. Cita Literaria ​

2. Mensaje de Advertencia ​

3. Mensaje de Consejo ​

4. Nota Importante ​

Errores Comunes y Soluciones ​

1. Falta el símbolo > ​

2. Error de Nivel de Anidamiento ​

3. Manejo de Líneas en Blanco ​

Buenas Prácticas ​

1. Mantén el Estilo Consistente ​

2. Usa el Anidamiento de Forma Apropiada ​

3. Uso Semántico ​

Salida HTML ​

Estilos Personalizados ​

Admoniciones estilo GitHub ​

Usando HTML y CSS ​

Ejemplos Prácticos ​

Ejemplo en Documentación de API ​

Notas en Tutoriales ​

Sintaxis Relacionada ​

Práctica ​

Sintaxis de Citas

Sintaxis Básica de Citas

Cita de una sola línea

Cita de varias líneas

Párrafos en Citas

Citas Anidadas

Anidamiento Básico

Anidamiento de varios niveles

Otros Elementos en Citas

Formato en Citas

Encabezados en Citas

Encabezado en Cita

Subencabezado

Listas en Citas

Bloques de Código en Citas

Enlaces en Citas

Escenarios Comunes de Uso

1. Cita Literaria

2. Mensaje de Advertencia

3. Mensaje de Consejo

4. Nota Importante

Errores Comunes y Soluciones

1. Falta el símbolo >

2. Error de Nivel de Anidamiento

3. Manejo de Líneas en Blanco

Buenas Prácticas

1. Mantén el Estilo Consistente

2. Usa el Anidamiento de Forma Apropiada

3. Uso Semántico

Salida HTML

Estilos Personalizados

Admoniciones estilo GitHub

Usando HTML y CSS

Ejemplos Prácticos

Ejemplo en Documentación de API

Notas en Tutoriales

Sintaxis Relacionada

Práctica