Markdown es un lenguaje de marcado ligero creado por John Gruber y Aaron Swartz que trata de conseguir la máxima legibilidad y facilidad de publicación tanto en su forma de entrada como de salida.
En principio, fue pensado para elaborar textos cuyo destino iba a ser la web con más rapidez y sencillez que si estuviésemos empleando directamente HTML. Markdown es realmente dos cosas: por un lado, el lenguaje; por otro, una herramienta de software que convierte el lenguaje en HTML válido.
Los archivos MarkDawn utilizan la extensión ‘.md’ y pueden ser ejecutados bajo la extensión .html.
La sintaxis es muy sencilla y cuenta con varias opciones diferentes para algunos de sus elementos. Básicamente, se trata de añadir ciertos caracteres al inicio de la línea o antes y después de los elementos a los que vamos a aplicar el formato.
Los espacios en el lenguaje MarkDown tienen gran importacia. Un espacio se comportará de manera normal, dos espacios es el máximo que podemos separar dos elementos, ya que a partir de dos espacios, todos los restantes se anula.
Si al terminar una línea no incorporamos ningún espacio, MarkDown interpreta que debe solaparlo con la siguiente línea e introduce un espacio. Para realizar
un salto de página y que los elementos permanezcan en distintas líneas, simplemente introducimos dos espacios al final de la línea.
# : Encabezado Grande.
## : Encabezado Medio.
### : Encabezado Pequeño.
Para marcar un texto, introducimos el texto entre comillas cerradas. Ejemplo
`Ejemplo`
Usaremos un asterisco antes y después para las cursivas y dos asteriscos para las negritas, ambos sin espacios.
*cursiva* : cursiva
**negrita** : negrita
En MarkDown podremos crear dos tipos de listas, numeradas y sin numerar. Para generar listas numeradas utilizaremos números
seguidos de un punto y un espacio, una vez hemos escrito el primero (1. Por ejemplo.), simplemente al terminar pulsamos
enter y automáticamente creará el siguiente:
Para crear listas sin numerar el proceso es el mismo, simplemente escribimos asterisco * al inicio de cada línea seguido
de un espacio. Tras escribir el elemento listado pulsamos enter y saltará a la siguiente línea ejecutando el asterisco
automáticamente:
Para poder introducir hipervínculos tanto en textos, enunciados o imágenes, podemos usar el siguiente parámetro
[](). Algo que debemos tener en cuenta es que si queremos redirigirnos a un archivo .md (MarkDown) pero que se nos
muestre en HTML, debemos escribirlo con la extensión .html para que se nos muestre correctamente.
[Texto](Ruta del hipervínculo)
[Ejemplo](https://ejemplo.com)
En la ruta del hipervínculo podemos tanto introducir el dominio de una página (como el ejemplo anterior) o redirigir a un archivo local. Para ello simplemente establecemos la ruta desde el archivo desde el que nos encontremos.
[Ejemplo](./Ejemplo1.html)
De esta forma nos redirige al archivo Ejemplo1.html situado en el mismo directorio que en el que nos encontramos ./ .
[Ejemplo2](../Ejemplo2.html)
En este caso retrocedemos un directorio con ../ y nos lleva al archivo Ejemplo2.html.
Para generar links automáticos tan solo tendrás que rodearlos con los símbolos < >
<https://f1r0x.github.io>
Para poder crear links dentro de nuestra página, por ejemplo para crear un índice o para establecer links a otros artículos, usaremos los siguientes comandos:
[Titulo del artículo](#item1) → Para los títulos del índice.
<a name=»item1″></a> → Marca a la que salta el enlace anterior.
El primer parámetro será dode estableceremos el link, mientras que el segundo nos indica a donde queremos desplazarnos.
Para poder mostrar información dentro de un bloque de forma que resalte y se pueda copiar su contenido de manera más eficiente, simplemente pulsamos cuatro veces espacio, una vez tengamos cuatro espacios desde el inicio de la línea, MarkDown interpretará que todo el contenido posterior va dentro de un bloque:
Ejemplo
Si quieres crear un bloque entero que contenga código. Lo único que tienes que hacer es encerrar dicho párrafo entre dos líneas formadas por tres ~ virgulillas.
Ejemplo1
Ejemplo2
Ejemplo3
De igual modo que el bloque anterior, podemos crear un bloque de códido específico para un lenguaje de programación. Para especificar el lenguaje simplemente añadimos su extension al final de las tres primeras comillas.
Ejemplo Python
```py
print("Hello World")
``` ```py
print(“Hello World”)
```
Para establecer cualquier otro leguaje de programación, solo debemos sustituir py por la extensión deaseada.
Para introducir líneas horizontales que separen los distintos apartados podemos utilizar tres asteriscos ***, tres guiones --- o tres
barras bajas ___.
Insertar una imagen con Markdown se realiza de una manera prácticamente idéntica a insertar links, con la diferencia que primero incorporamos un
signo de exclamación ![]()
El texto alternativo es lo que se mostraría si la carga de la imagen fallase.
También podrás añadir un título alternativo entrecomillándolo al final de la ruta. Esto sería el título mostrado al dejar el cursor del ratón sobre la imagen.
