Guía Completa de Markdown con Explicaciones de Activación

Ya tenemos soporte de Markdown en estos foros. Esta guía explica cómo activar cada característica del Markdown. Incluye la sintaxis exacta para cada elemento, junto con ejemplos prácticos. El Markdown sigue el estándar CommonMark, y algunas extensiones dependen del renderizador (como GitHub o editores web).

Encabezados

Los encabezados se activan usando de 1 a 6 símbolos # al inicio de la línea, seguidos de un espacio y el texto. El número de # define el nivel (H1 a H6). El cierre no es necesario, pero se recomienda una línea en blanco después.

Encabezado 1 (usar un solo #)

Encabezado 2 (usar dos ##)

Encabezado 3 (usar tres ###)

Encabezado 4 (usar cuatro ####)

Encabezado 5 (usar cinco #####)

Encabezado 6 (usar seis ######)

Alternativa: Subrayar con = (para H1) o - (para H2) después del texto en la línea siguiente.

Encabezado 1

Encabezado 2

Texto Enfatizado

• Negrita: Rodea el texto con dos asteriscos (texto) o guiones bajos (texto). Se activa en cualquier parte del párrafo.
• Cursiva: Usa un asterisco (texto) o guión bajo (_texto*).
• Negrita y cursiva: Combina ambos, como texto o texto.
• Texto tachado: Rodea con dos tilde (_texto). Esta es una extensión de GitHub Flavored Markdown (GFM), no estándar en todos los renderizadores.

Listas

Listas No Ordenadas

Se activan con - , * o + al inicio de cada línea, seguido de un espacio. No uses sangría para subelementos; el renderizador los maneja automáticamente. Mantén consistencia en el símbolo para toda la lista.

• Elemento uno con viñeta simple. (usar - o * o +)
• Elemento dos que puede contener subtexto.
• Elemento tres con un enlace: Enlace a Google.

Listas Ordenadas

Usa números seguidos de un punto y espacio (1. texto). El orden numérico no importa; el renderizador genera la secuencia. Para sublistas, sangría con espacios (4 espacios por nivel).

1. Primer paso: Preparar ingredientes. (usar 1. o cualquier número)
2. Segundo paso: Mezclar todo.
3. Tercer paso: Hornear durante 30 minutos.

Enlaces e Imágenes

Enlaces

• Inline: Texto. El título es un tooltip.
• Referencia: [Texto][id] seguido de [id]: URL en cualquier lugar (incluso al final del documento). Para ocultar, usa [Texto][] con id vacío.

Enlace externo: Sitio de Markdown.
Enlace de referencia: Referencia Markdown.

Imágenes

Similar a enlaces, pero con ! al inicio. Soporta inline o referencia. El alt text es descriptivo para accesibilidad.

• Inline: .
• Referencia: ![Alt text][id] con [id]: URL.

Imagen inline: ![Logo de Markdown](https://via.placeholder.com
Imagen con referencia: .

Citas

Se activan con > al inicio de la línea (bloque de cita). Para anidar, usa >> en la sub-línea. Puedes incluir otros elementos Markdown dentro.

Esta es una cita de bloque. Puede abarcar múltiples líneas.
(usar > para cada línea)

• Autor anónimo

Citas anidadas:

Cita principal. (usar >)

Cita secundaria dentro de la principal. (usar >>)

Código

Código Inline

Rodea con una comilla inversa (backtick) texto. Úsala para resaltar código en párrafos.

Usa una sola comilla invertida para código en línea: print("Hola, mundo").

Bloques de Código

Usa tres backticks (```) al inicio y final del bloque. Opcional: Especifica el lenguaje después de los primeros ``````python).

def funcion_ejemplo(parametro):  (rodear con ```python y ```
    """Documentación de función."""
    if parametro > 0:
        return "Positivo"
    else:
        return "No positivo"

# Llamada a la función
resultado = funcion_ejemplo(5)
print(resultado)

Alternativa indentada: Sangría de 4 espacios por línea (menos común en Markdown moderno).

Bloque de código con sintaxis específica (por ejemplo, bash):

#!/bin/bash  (usar ```bash)
echo "Instalando dependencias..."
pip install requests

Tablas

Se activan con | para separar columnas y - para la línea de cabecera (al menos 3 por columna). Usa : para alinear (izquierda :-, centro :-:, derecha -:).

Alineación en tablas:

Líneas Horizontales

Actívalas con tres o más - , * o _ en una línea sola, con espacios opcionales. Sirven para separar secciones.

Separa secciones con líneas horizontales: (usar --- o ***)

O con tres guiones: (usar ***)

Elementos Avanzados

Tareas (Listas de Verificación)

Extensión de GFM: Usa - [ ] para pendiente o - [x] para completado. Combina con listas.

• [x] Tarea completada. (usar [x])
• [ ] Tarea pendiente. (usar [ ])
• [x] Otra tarea hecha.

Notas Laterales (HTML en Markdown)

El Markdown permite HTML crudo. Para <details>, usa la etiqueta completa; se renderiza en la mayoría de plataformas.

<details> (etiqueta HTML <details>)
<summary>Haz clic para expandir</summary>

Contenido oculto que se revela al hacer clic. Esto es útil para spoilers o detalles adicionales.

</details>

Tabla de Contenidos Automática (Extensión)

En renderizadores como GitHub, inserta [TOC] donde quieras el índice. No es estándar; genera automáticamente basado en encabezados.

Algunos renderizadores soportan [TOC] para generar índices automáticamente, pero en Markdown puro se inserta manualmente.

Combinaciones y Mejores Prácticas

Puedes combinar elementos, pero evita complejidades excesivas para compatibilidad.

• Lista con código:
• Usa inline code en listas. (backticks en item)
• Incluye énfasis donde sea necesario.

Esta guía ampliada cubre la activación precisa de cada elemento. Prueba en editores como Dillinger o VS Code para ver el renderizado en tiempo real. Para variaciones específicas (como en Reddit o Stack Overflow), consulta su documentación.