Markdown explicado en 5 minutos

Probablemente ya has usado Markdown sin saberlo. ¿Alguna vez escribiste **negrita** en un mensaje de Slack? ¿Redactaste un README en GitHub? ¿Formateaste una publicación en Reddit? Eso es Markdown.

Markdown es una forma ligera de formatear texto plano usando símbolos simples. En lugar de hacer clic en botones de la barra de herramientas para negrita, cursiva, encabezados y listas, escribes unos pocos caracteres que indican el formato que deseas. Fue creado en 2004 por John Gruber y Aaron Swartz, y desde entonces se ha convertido en el lenguaje de formato predeterminado para desarrolladores, escritores y cualquiera que trabaje con texto en la web.

Por qué existe Markdown

Antes de Markdown, dar formato al texto para la web significaba escribir HTML. Para poner una palabra en negrita, escribías <strong>negrita</strong>. Para crear una lista, necesitabas <ul><li>elemento</li></ul>. HTML es potente pero verboso y difícil de leer en su forma bruta.

Markdown resuelve esto proporcionando una abreviatura legible para humanos. El texto sin procesar es fácil de leer incluso antes de renderizarse. El resultado formateado es limpio y profesional. Obtienes lo mejor de ambos mundos: texto fuente legible y resultado pulido.

La sintaxis esencial

Aquí está todo lo que necesitas saber para empezar a usar Markdown de forma productiva.

Encabezados

Usa el símbolo almohadilla (#) para crear encabezados. Más almohadillas significan encabezados más pequeños.

# Encabezado 1 (más grande)
## Encabezado 2
### Encabezado 3
#### Encabezado 4

Negrita y cursiva

Envuelve el texto en asteriscos o guiones bajos:

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

Listas

Las listas desordenadas usan guiones, asteriscos o signos más. Las listas ordenadas usan números.

- Primer elemento
- Segundo elemento
- Tercer elemento

1. Primer paso
2. Segundo paso
3. Tercer paso

Enlaces

Corchetes para el texto, paréntesis para la URL:

[Haz clic aquí](https://example.com)

Imágenes

Como los enlaces, pero con un signo de exclamación delante:

![Texto alternativo](imagen-url.jpg)

Citas

Usa el símbolo mayor que:

> Esta es una cita. Se mostrará con sangría y estilo diferente.

Código

Comillas invertidas para código en línea, triple comillas invertidas para bloques de código:

Usa la función `print()` para mostrar texto.

Para bloques de código multilínea, usa triple comillas invertidas con un identificador de lenguaje opcional:

```python
def hello():
    print("Hello, world!")
```

Líneas horizontales

Tres o más guiones, asteriscos o guiones bajos:

---

Tablas

Usa barras verticales y guiones:

| Nombre | Rol | Ubicación |
| --- | --- | --- |
| Alice | Desarrolladora | Berlín |
| Bob | Diseñador | Londres |

Dónde se usa Markdown

Markdown está en todas partes:

Desarrollo de software

• GitHub, GitLab, Bitbucket: Los READMEs, issues, pull requests y documentación se escriben en Markdown.
• Stack Overflow: Las preguntas y respuestas usan formato Markdown.
• Documentación de código: Muchos generadores de documentación (Docusaurus, MkDocs, Jekyll) usan Markdown como formato fuente.

Comunicación

• Slack: Admite un subconjunto de Markdown para el formato de mensajes.
• Discord: Usa Markdown para negrita, cursiva, bloques de código y más.
• Reddit: Las publicaciones y comentarios se formatean con Markdown.

Escritura y publicación

• Blogs: Muchos generadores de sitios estáticos usan archivos Markdown como fuentes de contenido.
• Libros: Varias herramientas de publicación aceptan manuscritos en Markdown.
• Notas: Aplicaciones como Obsidian, Notion, Bear y Typora están construidas en torno a Markdown.

Documentación

• Documentación técnica: La documentación de APIs, guías de usuario y wikis comúnmente usan Markdown.
• Bases de conocimiento internas: Muchos equipos usan wikis basadas en Markdown.

Variantes de Markdown

Algo que debes saber: existen diferentes "variantes" de Markdown. La sintaxis básica es la misma en todas partes, pero algunas plataformas añaden extensiones:

Las diferencias están principalmente en funciones avanzadas. Lo básico (encabezados, negrita, cursiva, listas, enlaces, imágenes, código) funciona igual en todas partes.

Errores comunes

Olvidar las líneas en blanco

Markdown requiere una línea en blanco antes y después de muchos elementos. Un encabezado necesita una línea en blanco antes. Una lista necesita una línea en blanco antes y después. Olvidar estas líneas en blanco es la fuente más común de problemas de renderizado.

Marcadores de lista inconsistentes

Mezclar -, * y + en la misma lista puede causar un renderizado inesperado. Elige uno y úsalo siempre.

Espacios después de los símbolos

Algunos procesadores de Markdown requieren un espacio después del # en los encabezados y después del - en las listas. Incluye siempre el espacio para estar seguro.

# Encabezado correcto
#Encabezado incorrecto

- Elemento de lista correcto
-Elemento de lista incorrecto

Por qué vale la pena aprender Markdown

Markdown se aprende en cinco minutos y ahorra horas con el tiempo. Una vez que lo conoces, puedes:

• Escribir documentación que se renderiza de forma atractiva en GitHub
• Formatear mensajes en Slack y Discord sin tocar el ratón
• Tomar notas estructuradas que son portables entre aplicaciones
• Crear publicaciones de blog y contenido web desde archivos de texto plano
• Colaborar en documentos basados en texto sin problemas de compatibilidad de formato

La relación inversión-beneficio es una de las mejores en todo el mundo tecnológico.

Empieza a escribir en Markdown ahora mismo:

• Escribe y previsualiza Markdown
• Herramienta de vista previa de Markdown

Gratis, en tu navegador, con vista previa en tiempo real mientras escribes.