¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero, es una forma sencilla de escribir y dar estilo a un texto y es una de las formas de escribir contenido en Jekyll.

Markdown es sencillo de escribir y de leer, es un formato que es facil de convertir a otros formatos como HTML, PDF, etc.
La sencillez de Markdown restringe sea de paso, el que se complique el texto, al permitir un estilo sencillo.

Nota: En Jekyll los archivos de contenido son encabezados por YAML y pueden contener HTML y tags liquid.

Formato de texto en Markdown

En Markdown se le puede dar formato al texto usando las siguientes opciones:

Texto con énfasis

Se le agrega énfasis al texto encerrandolo entre asteriscos “*” o subrayado “_”

*énfasis*, o _énfasis_ (normalmente se convierte a cursiva)
**énfasis fuerte**, o __énfasis fuerte__ (normalmente se convierte a negrita)

Títulos o encabezados

El estilo de los encabezados se da precediendo el texto con almohadillas “#”, de manera que a menor cantidad de almohadillas mayor la prioridad

# Primer nivel
## Segundo nivel
### Tercer nivel
...
###### Sexto nivel

Pero además los primeros 2 niveles se pueden definir usando una linea de caracteres de igual “=” o resta “-“

Primer nivel
============

Segundo nivel
-------------

Listas

Las listas se definen usando un asterisco “*” 0 un menos “-“ y un espacio antes de la linea para listas no numeradas y un numero con un punto y un espacio para las listas numeradas.

* Rojo
* Amarillo
* Verde
* Azul

1. Primer elemento
2. Segundo elemento
3. Tercer elemento

Código

Para cuando se quiere definir código en el texto se usan el caracter “`” tanto para código en la misma linea o encerrado en 3 caracteres consecutivos para código de varias lineas.

Este código `hola` esta en la misma línea que el texto.

```
Código de varias
  lineas que
  respeta tabs y
espacios
```

En Jekyll se puede usar también pigmentos (pygments) para hacer destacado de sintaxis.

{% highlight sql %}
SELECT * FROM TABLE
{% endhighlight %}

Citas

Las citas de texto se preceden con el caracter mayor que “>” antes de cada linea.

> Esta es una cita que en HTML será convertida a un "blockquote"

Enlaces

Los enlaces se crean encerrando el texto en parentesis cuadrados junto al enlace entre parentesis redondos y opcionalmente el título del enlace entre comillas junto al enlace.

[Este es un enlace](http://www.elsitio.com "Titulo va aquí")

Imagenes

Las imágenes se escriben parecido a los enlaces pero precedidos por un signo de exclamación “!”

![Texto alternativo](http://www.elsitio.com/imagen.png "Titulo de la
imágen")

De esta manera se tiene un código muy sencillo para escribir texto con estilo.