¿Qué es Markdown y cómo usarlo?
Markdown es un lenguaje de marcado ligero que te permite crear texto formateado utilizando un editor de texto simple. Originalmente creado por John Gruber en 2004, Markdown es ampliamente utilizado para documentación, blogs, toma de notas e incluso para formatear contenido en sitios web y aplicaciones.
En este artículo, cubriremos qué es Markdown, dónde se usa comúnmente y cómo aplicar sus características de formato más esenciales.
¿Qué es Markdown?
Markdown es una forma sencilla de dar estilo al texto en la web. En lugar de utilizar etiquetas HTML complejas o editores WYSIWYG, Markdown permite a los usuarios escribir utilizando una sintaxis legible de texto plano, que luego se convierte en HTML.
Por ejemplo, para poner texto en negrita, simplemente lo envuelves en asteriscos dobles como **esto**, y para crear una lista, puedes usar guiones o números.
Markdown es popular por su equilibrio entre simplicidad y flexibilidad, lo que lo hace accesible tanto para usuarios técnicos como no técnicos.
Casos de uso comunes de Markdown
Markdown se utiliza en muchos lugares donde es necesario dar estilo o estructurar texto plano.
Documentación técnica
Los desarrolladores y redactores técnicos a menudo usan Markdown para escribir documentación debido a su legibilidad y fácil integración con sistemas de control de versiones como Git.
Archivos README en GitHub
GitHub admite Markdown de forma nativa para archivos README y documentación. Es el formato predeterminado para presentar y explicar un proyecto.
Blogs y redacción de contenido
Muchos generadores de sitios estáticos modernos como Jekyll, Hugo y Next.js admiten Markdown para la creación de contenido. También lo utilizan plataformas de blogs como Ghost y Dev.to.
Aplicaciones para tomar notas
Aplicaciones como Obsidian, Notion (soporte parcial) y Bear permiten a los usuarios escribir notas utilizando la sintaxis de Markdown para facilitar el formateo.
Formato de correo electrónico y mensajería
Algunos clientes de correo electrónico y plataformas de mensajería (como Slack y Discord) permiten sintaxis Markdown parcial para formato básico como negrita, cursiva o bloques de código.
Sintaxis básica de Markdown y cómo usarla
La sintaxis de Markdown es sencilla y legible por humanos. Aquí están los elementos más comunes que necesitarás.
Encabezados
Usa los símbolos # para crear encabezados. El número de símbolos # corresponde al nivel del encabezado.
# H1 - Título principal
## H2 - Título de sección
### H3 - Título de subsección
Énfasis
Puedes enfatizar el texto con cursiva o negrita:
*Texto en cursiva* o _Texto en cursiva_
**Texto en negrita** o __Texto en negrita__
***Negrita y cursiva*** o ___Negrita y cursiva___
Listas
Markdown admite listas desordenadas y ordenadas.
-
Lista desordenada:
- Elemento 1 - Elemento 2 - Sub-elemento -
Lista ordenada:
1. Primer elemento 2. Segundo elemento 1. Elemento anidado
Enlaces
Para agregar un hipervínculo, usa corchetes para el texto y paréntesis para la URL:
[Visita OpenAI](https://www.openai.com)
Imágenes
Las imágenes usan la misma sintaxis que los enlaces, pero comienzan con un signo de exclamación:
Citas en bloque
Para crear una cita en bloque, antepón la línea con >:
> Esto es una cita en bloque.
Código y bloques de código
Para código en línea, envuelve el texto con comillas invertidas:
Usa la función `console.log()`.
Para bloques de código de varias líneas, usa comillas invertidas triples:
```javascript
function greet(name) {
return `Hola, ${name}`;
}
```
Regla horizontal
Usa tres o más guiones, asteriscos o guiones bajos para crear una línea horizontal:
---
Tablas
Las tablas de Markdown utilizan barras verticales y guiones:
| Sintaxis | Descripción |
|--------|-------------|
| Encabezado | Título |
| Celda | Contenido |
Consejos para escribir en Markdown
- Utiliza una herramienta de vista previa de Markdown (como VS Code, Typora o StackEdit) para ver instantáneamente el resultado.
- Al escribir documentos más extensos, organiza tus secciones con encabezados adecuados.
- Utiliza un formato coherente para mantener la claridad.
- Utiliza comentarios (estilo HTML
<!-- Comment -->) para dejar notas que no aparecerán en el resultado final.