Aprende a usar markdown
2 minutos de lectura
Fecha: 5/9/2021
El Markdown es un lenguaje de marcado al igual que también lo es HTML. Y posiblemente de este tipo de lenguajes sea de los más sencillos de aprender y uno de los más útiles.
Está enfocado para que puedas escribir en una web sin tener conocimientos de HTML precisamente porque su propósito inicial fue la de poder convertir texto plano en HTML.
Esto nos va a ser muy útil siempre, desde para documentar las aplicaciones, de hecho cuando ves la documentación de una en Github suele ser un archivo readme.md. Hasta para introducir contenido en blogs o usarlo de forma offline.
La gran ventaja es que es compatible con cualquier plataforma y muy fácil de aprender.
Una vez definido lo que es, vamos a aprender a usarlo, viendo su sintaxis que como decíamos es muy básica. Voy a poner un ejemplo:
Ejemplo de texto enriquecido
Esto es un párrafo que contiene textos en negrita, también en cursiva y un listado:
- El primer elemento
esta tachado - El segundo tiene un link a la página de google
- Y por último en negrita y cursiva al mismo tiempo
Y ya paramos con el ejemplo, veamos como es el código HTML para conseguir todo esto.
<h3>Ejemplo de texto enriquecido</h3>
<p>Esto es un párrafo que contiene <strong>textos en negrita</strong>, también <em>en cursiva</em> y un listado:</p>
<ul>
<li>El primer elemento <del>esta tachado</del></li>
<li>El segundo tiene un <a href="https://www.google.com/" target="_blank" rel="noopener">link a la página de google</a></li>
<li>Y por último en <em><strong>negrita y cursiva al mismo tiempo</strong></em></li>
</ul>
No es tampoco super complejo pero aun así veamos como seria con Markdown:
### Ejemplo de texto enriquecido
Esto es un párrafo que contiene **textos en negrita**, también _en cursiva_ y un listado:
- El primer elemento ~~esta tachado~~
- El segundo tiene un [link a la página de google](https://www.google.com/)
- Y por último en _**negrita y cursiva al mismo tiempo**_
Como vemos es más sencillo, realmente merece la pena aprenderlo porque cuesta poco y simplifica mucho. Además de que podremos usarlo en más contextos que en la web.
Vamos a explicar esta sintaxis.
Encabezados
La primera linea es un encabezado de nivel 3, y vemos que para transformarlo simplemente hemos puesto 3 almohadillas (###). Ya se intuye por donde van los tiros pero os dejo las equivalencias de todas formas:
# Encabezado 1
## Encabezado 2
### Encabezado 3
#### Encabezado 4
##### Encabezado 5
###### Encabezado 6
También para los encabezados de nivel 1 y 2 lo puedes hacer te esta manera
Encabezado 1
==
Encabezado 2
—
No existe un numero establecido de = o – que hay que poner, yo he puesto 2 por costumbre pero podrías poner 1 y también vale. Esta manera no me gusta mucho porque te limita a solo a 2 niveles y además esta muy poco extendida, asi que no la suelo usar.
Formato de texto
Algo que usaremos bastante es el formateo de los textos, es super sencillo y solo tenemos que usar cierto numero de caracteres para encapsular el texto al que queremos dar formato.
Os dejo también las opciones:
Texto en cursiva: Puedes usar esta manera cursiva o esta otra cursiva
Texto en negrita: Puedes usar esta manera negrita o esta otra negrita
Texto en negrita y cursiva: Puedes usar esta manera negrita y cursiva o esta negrita y cursiva o esta negrita y cursiva
Tachar texto: Puedes usar esta manera tachado
Y esto equivale a:
Texto en cursiva: Puedes usar esta manera *cursiva* o esta otra _cursiva_
Texto en negrita: Puedes usar esta manera **negrita** o esta otra __negrita__
Texto en negrita y cursiva: Puedes usar esta manera ***negrita y cursiva*** o esta ___negrita y cursiva___ o esta _**negrita y cursiva**_
Tachar texto: Puedes usar esta manera ~~tachado~~
Por cierto, para hacer un salto de línea deja dos espacios en blanco.