Si alguna vez has escrito un documento utilizando símbolos como #, * o ** para dar formato al texto, probablemente ya hayas utilizado Markdown, aunque no lo supieras.

Markdown es un lenguaje de marcado ligero que permite aplicar formato a textos utilizando una sintaxis sencilla. Su principal ventaja es que podemos escribir títulos, listas, enlaces, imágenes, tablas y otros elementos sin necesidad de utilizar un editor visual complejo.

Fue creado originalmente por John Gruber y Aaron Swartz y, con el paso de los años, se ha convertido en una herramienta muy utilizada en programación, documentación, blogs, foros y plataformas como GitHub.

¿Qué es exactamente Markdown?

Markdown es un sistema para dar formato al texto mediante determinados caracteres.

Por ejemplo, para crear un título podemos escribir:

# Este es un título

Para un subtítulo:

## Este es un subtítulo

Y para escribir una palabra en negrita:

**palabra importante**

La idea es que el documento siga siendo perfectamente legible incluso cuando estamos viendo el código Markdown sin convertir.

Una de las grandes ventajas es precisamente su sencillez.

¿Para qué sirve Markdown?

Markdown se utiliza principalmente para crear contenido estructurado de forma rápida.

Podemos utilizarlo para:

• Documentación de proyectos.
• Artículos y blogs.
• Archivos README.
• Notas personales.
• Documentación técnica.
• Publicaciones en determinadas plataformas.
• Mensajes y contenidos con formato.
• Apuntes.
• Páginas web.
• Documentación de software.

Una de las plataformas donde Markdown tiene una presencia especialmente importante es GitHub, donde se utiliza habitualmente para crear archivos README y documentar proyectos.

También podemos consultar la documentación de GitHub sobre Markdown para conocer su sintaxis.

Cómo escribir títulos con Markdown

Los títulos se crean utilizando el símbolo #.

Cuantos más símbolos añadamos, menor será el nivel del encabezado:

# Título principal

## Segundo nivel

### Tercer nivel

#### Cuarto nivel

En un artículo para una página web, normalmente utilizaremos # para el título principal y ## y ### para organizar las diferentes secciones.

Cómo poner texto en negrita y cursiva

Para escribir texto en negrita, debemos colocar dos asteriscos antes y después:

**Texto en negrita**

Para utilizar cursiva, podemos utilizar un solo asterisco:

*Texto en cursiva*

También podemos combinar ambos formatos:

***Texto en negrita y cursiva***

Es una forma muy rápida de destacar determinadas palabras.

Cómo crear listas

Markdown permite crear listas de una forma muy sencilla.

Una lista sin numeración se puede escribir así:

- Primer elemento
- Segundo elemento
- Tercer elemento

El resultado será:

• Primer elemento
• Segundo elemento
• Tercer elemento

También podemos crear listas numeradas:

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

Esto resulta especialmente útil para tutoriales y guías paso a paso.

Cómo añadir enlaces

Los enlaces tienen una sintaxis muy sencilla:

[Google](https://www.google.com/)

El texto que aparece entre los corchetes será el que verá el usuario, mientras que la dirección entre paréntesis será el destino del enlace.

Por ejemplo, podemos escribir:

Consulta la [documentación de Markdown](https://www.markdownguide.org/).

También existe una guía muy completa en Markdown Guide, donde se puede consultar la sintaxis y diferentes ejemplos.

Cómo insertar imágenes

Las imágenes utilizan una sintaxis similar a los enlaces, pero incorporando ! al principio:

![Descripción de la imagen](imagen.jpg)

La descripción entre corchetes sirve como texto alternativo de la imagen.

Esto resulta especialmente interesante para documentación y contenidos publicados en plataformas compatibles con Markdown.

Cómo crear citas

Para crear una cita podemos utilizar el símbolo >:

> Esta es una cita.

Podemos utilizarlo para destacar una frase o reproducir una referencia dentro de un documento.

También es posible crear citas de varios párrafos utilizando el mismo sistema.

Cómo crear código

Markdown también resulta muy útil para quienes trabajan con programación.

Para destacar una palabra o fragmento corto de código podemos utilizar una comilla invertida:

`print("Hola mundo")`

Para bloques de código más grandes podemos utilizar tres comillas invertidas:

```python
print("Hola mundo")

Además, podemos indicar el lenguaje utilizado para que determinadas plataformas puedan aplicar resaltado de sintaxis.

## Cómo hacer tablas

Markdown también permite crear tablas.

Por ejemplo:

```text
| Producto | Precio |
|---|---:|
| Teclado | 30 € |
| Ratón | 20 € |
| Monitor | 150 € |

El resultado será una tabla con filas y columnas.

Esta función resulta especialmente útil en documentación técnica, comparativas y archivos README.

Markdown frente a HTML

Una pregunta habitual es si Markdown sustituye a HTML.

No exactamente.

Markdown está pensado para facilitar la escritura de contenido con formato. HTML, en cambio, es un lenguaje de marcado mucho más completo que permite controlar numerosos aspectos de la estructura de una página web.

De hecho, muchos sistemas convierten Markdown a HTML automáticamente.

Por eso Markdown puede ser una alternativa mucho más cómoda cuando únicamente necesitamos escribir contenido estructurado sin tener que utilizar etiquetas HTML constantemente.

¿Dónde podemos utilizar Markdown?

Actualmente podemos encontrar Markdown en numerosos lugares.

GitHub es uno de los ejemplos más conocidos, especialmente para documentación de proyectos de software. También existen aplicaciones de notas, gestores de contenidos, plataformas de documentación y editores que permiten trabajar directamente con Markdown.

Para aprender la sintaxis completa, Markdown Guide ofrece una referencia práctica con ejemplos de elementos básicos y avanzados.

Ventajas de utilizar Markdown

Entre sus principales ventajas encontramos:

• Es fácil de aprender.
• Permite escribir rápidamente.
• Los documentos son fáciles de leer incluso sin formato.
• No requiere conocimientos avanzados de HTML.
• Funciona en numerosas plataformas.
• Es muy utilizado en documentación técnica.
• Los archivos son ligeros y fáciles de editar.
• Permite combinar texto, enlaces, imágenes, listas, tablas y código.

Conclusión

Markdown es una herramienta sencilla pero muy potente para escribir contenido estructurado.

Su sintaxis se puede aprender en muy poco tiempo y, una vez dominados elementos como los títulos, las listas, los enlaces, las imágenes y los bloques de código, podemos crear documentos bastante completos sin necesidad de utilizar un editor visual.

Para alguien que escribe artículos, documentación, tutoriales o trabaja con proyectos de programación, aprender Markdown puede ahorrar bastante tiempo.

Además, su popularidad hace que los conocimientos adquiridos puedan reutilizarse en numerosas plataformas compatibles con este sistema.