¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004. Su objetivo es permitir escribir texto formateado usando una sintaxis simple y legible que puede convertirse fácilmente a HTML y otros formatos. Es ampliamente utilizado para documentación, blogs, README files y plataformas como GitHub.

¿Para qué sirve Markdown?

Markdown es ideal para múltiples casos de uso:

• Escribir documentación técnica de forma rápida y clara.
• Crear archivos README para proyectos de GitHub.
• Redactar artículos para blogs y sitios web estáticos.
• Tomar notas estructuradas y organizadas.
• Generar contenido que se puede exportar a múltiples formatos.

¿Cómo funciona?

Imagina Markdown como un taquígrafo inteligente. Usas símbolos simples (#, *, **) para indicar el formato que quieres, y el texto permanece legible incluso sin procesar. Luego, un procesador convierte estos símbolos en HTML formateado automáticamente.

Ejemplo: Sintaxis básica de Markdown

Markdown utiliza caracteres especiales para formatear texto de manera intuitiva:

# Título principal (H1)
## Subtítulo (H2)
### Subtítulo menor (H3)

**Texto en negrita** y *texto en cursiva*

- Lista con viñetas
- Otro elemento
- Un elemento más

1. Lista numerada
2. Segundo elemento
3. Tercer elemento

[Enlace a Google](https://google.com)

![Imagen](https://ejemplo.com/imagen.jpg)

`Código inline` y bloques de código:

```javascript
function saludo() {
  console.log("¡Hola mundo!");
}

---

Este ejemplo muestra la sintaxis fundamental: títulos, énfasis, listas, enlaces, imágenes y código.

¿Qué es MDX?

MDX es una extensión de Markdown que permite usar componentes JSX directamente en archivos Markdown. Combina la simplicidad de Markdown con el poder de React, permitiendo crear contenido interactivo y dinámico.

Ejemplo: MDX en acción

# Mi artículo con MDX

Este es contenido Markdown normal, pero también puedo usar componentes:

<Button variant="primary" onClick={() => alert('¡Hola!')}>
  Hacer clic aquí
</Button>

import { Chart } from './components/Chart'

<Chart data={salesData} />

## Más contenido Markdown

Y puedo seguir escribiendo en Markdown normalmente.

Características principales de Markdown/MDX

• Sintaxis simple: Fácil de aprender y escribir.
• Legible en texto plano: El archivo fuente es comprensible sin procesar.
• Portable: Se puede convertir a HTML, PDF, Word, etc.
• Ampliamente soportado: GitHub, Reddit, Discord, y muchas plataformas lo usan.
• MDX añade interactividad: Componentes React embebidos en Markdown.

¿Dónde encuentras Markdown/MDX?

• Archivos README en repositorios de GitHub.
• Documentación técnica (GitBook, Docusaurus, VuePress).
• Blogs estáticos (Gatsby, Next.js, Astro).
• Plataformas de notas (Obsidian, Notion, Typora).
• Sistemas de comentarios y foros.

Conclusión

Markdown democratiza la escritura formateada al eliminar la complejidad del HTML. MDX lleva esto un paso más allá, permitiendo crear contenido interactivo sin sacrificar la simplicidad. Ambos son herramientas esenciales para desarrolladores, escritores técnicos y creadores de contenido digital.

Aquí puedes ver una Cheatsheet completa de Markdown

---