La Guía Completa de Markdown

Markdown hace que el formato de texto sea simple y portátil

📋 Tabla de Contenidos

1. Introducción
2. Sintaxis Básica
3. Características Extendidas
4. Uso Avanzado
5. Buenas Prácticas
6. Recursos

Introducción

Markdown es un lenguaje de marcado ligero que te permite dar formato al texto usando una sintaxis simple. Creado en 2004 por John Gruber, ahora se usa ampliamente para:

• Documentación
• Archivos Readme
• Publicaciones de blogs
• Foros de discusión
• Toma de notas

Beneficios Clave: ✅ Fácil de aprender
✅ Portátil entre plataformas
✅ Legible incluso como texto plano
✅ Soporta HTML cuando es necesario

Sintaxis Básica

Encabezados

Formato de Texto

Itálica o Itálica
Negrita o Negrita
Negrita e Itálica
Tachado
==Resaltado==
Código en línea

Listas

Desordenadas

• Elemento 1
  • Sub-elemento 1
    • Sub-sub-elemento 1

Ordenadas

1. Primer elemento
2. Segundo elemento
   1. Elemento anidado

Mixtas

• Elemento A

1. Elemento B

• Elemento C

Listas de Tareas

• Tarea completada
• Tarea pendiente

Enlaces y Anclas

Enlaces Básicos

Enlaces de Ancla

Ir a Introducción Ir a Recursos Ir a otra página

Usa rutas relativas para enlaces internos y así asegurar portabilidad. Por ejemplo, [Texto del enlace](docs/other-page.md) enlazará a other-page.md en el directorio docs. Los enlaces internos también muestran un tooltip con el título y la descripción de la página de destino.

Entre Documentos

Ejemplo Original de Video

Video de YouTube como imagen enlazada:

Originalmente los videos no son soportados en Markdown, pero puedes enlazarlos usando imágenes o incrustar HTML.

Imágenes

Sintaxis básica de imagen:

Con opciones de formato:

Citas

Esto es una cita Que abarca varias líneas

Líneas Horizontales

---

Características Extendidas

Tablas

Bloques de Código

En línea

Usa console.log() para depuración

Resaltado de Sintaxis

Notas al Pie

Aquí hay una referencia de nota al pie¹

Uso Avanzado

Diagramas Mermaid

Integración HTML

Emojis

:rocket: :sparkles: :books:

Buenas Prácticas

1. La Consistencia Importa

   • Usa un solo estilo para encabezados, listas, etc.

2. Primero la Legibilidad

   • Mantén las líneas por debajo de 80 caracteres
   • Usa líneas en blanco entre secciones

3. Accesibilidad

   • Usa siempre texto alternativo descriptivo para imágenes
   • Usa texto de enlace significativo

4. Estructura del Documento

Recursos

• Guía Oficial de Markdown
• Tutorial Interactivo
• GitHub Flavored Markdown
• Hoja de Referencia PDF

¡Feliz escritura! ✍️

Footnotes

1. Este es el contenido de la nota al pie ↩