====== Markdown ======

Lenguaje de marcado ligero que trata de conseguir la máxima legibilidad y facilidad de publicación inspirándose en muchas convenciones existentes para marcar mensajes de correo electrónico usando texto plano. 

  * [[https://daringfireball.net/projects/markdown/|Web oficial]]

===== Versiones =====

Hay diferentes variantes de la concepción original de la sintaxis de Markdown, las más conocidas:

  * Markdown Extra
  * GitHub Flavored Markdown

===== Sintaxis =====

==== Encabezados ====

Se añade el símbolo ''#'' por cada nivel de encabezado:

<code markdown>
# Encabezado 1
## Encabezado 2
### Encabezado 3
#### Encabezado 4
##### Encabezado 5
###### Encabezado 6
</code>

==== Citas ====

Se utiliza el símbolo ''>'' antes de escribir la cita:

<code markdown>
> En un lugar de La Mancha de cuyo nombre no quiero acordarme. — Miguel de Cervantes
</code>

==== Listas ====

Para las **desordenadas** se pueden utilizar asteriscos, guiones o el signo ''+'':

<code markdown>
- Elemento de lista 1
- Elemento de lista 2
* Elemento de lista 3
* Elemento de lista 4
+ Elemento de lista 5
+ Elemento de lista 6
</code>

Si queremos anidar listas, hay que añadir los caracteres de lista después de 4 espacios en blanco:

<code markdown>
- Elemento de lista 1
- Elemento de lista 2
    - Elemento de lista 3
    - Elemento de lista 4
        - Elemento de lista 5
        - Elemento de lista 6
</code>

En cuanto a las **listas ordenadas**, se usa un número:

<code markdown>
1. Elemento de lista 1
2.  Elemento de lista 2
    - Elemento de lista 3
    - Elemento de lista 4
        1. Elemento de lista 5
        2. Elemento de lista 6
</code>

==== Negrita ====

Se pueden usar dos asteriscos o dos guiones bajos:

<code markdown>
**Esto está en negrito** y __esto también__
</code>

==== Cursiva ====

Se pueden usar asteriscos (solo 1) o guiones bajos (solo 1):

<code markdown>
*Esto está en cursiva* y _esto también_
</code>

==== Enlaces ====

<code markdown>
[Google](https://google.com)
</code>

==== Código ====

Para mostrar texto preformateado:

<code markdown>
`Esto es una línea preformateada`
</code>

Si vamos a poner más de una línea, podemos encerrarla entre 3 acentos graves:

<code markdown>
```
function hola() {
    echo "Hola, mundo!";
}
```
</code>

==== Imágenes ====

Añadir una imagen es casi igual que insertar enlaces, pero añadiendo el símbolo de exclamación al principio y el enlace será la ubicación de la imagen:

<code markdown>
![Texto alternativo](/ruta/a/la/imagen.jpg "Título alternativo")
</code>

===== Recursos =====

  * [[https://www.markdownguide.org/|The Markdown Guide]]
  * [[https://commonmark.org/help/tutorial/|Tutorial interactivo de Markdown]].