Sintaxis del formato Markdown
Este documento describe algunas de las partes más importantes del formato Markdown. Además de lo que se explica aquí hay mucho más. Puedes conocer la sintaxis completa en la página de John Gruber Sintaxis de Markdown (en inglés).
Cabeceras
Para los encabezamientos principales subraya el texto con el signo igual. Para los encabezamientos de segundo nivel utiliza guiones para subrayar.
Esto es un H1=============
|
Esto es un H1 |
Esto es un H2-------------
|
Esto es un H2 |
Si lo prefieres, puedes marcar los encabezamientos usando una almohadilla (#) como prefijo. El número de almohadillas indica el nivel del encabezamiento. Por ejemplo, una única almohadilla indica un encabezamiento de primer nivel mientras que dos indican uno de segundo nivel:
# Esto es un H1
|
Esto es un H1 |
## Esto es un H2
|
Esto es un H2 |
### Esto es un H3
|
Esto es un H3 |
Lo que elijas es una cuestión de preferencia. En ambos casos el documento formateado queda igual.
Párrafos
Los párrafos se separan mediante líneas en blanco.
Éste es el primer párrafo.
Éste es el segundo párrafo.
Enlaces
Los enlaces tienen dos partes.
La primera es el texto que el usuario verá, y se escribe entre corchetes.
La segunda es la dirección de la página hacia la que quieres enlazar y se escribe entre paréntesis.
[texto del enlace](http://ejemplo.com/)
|
texto del enlace |
Formato
Para indicar texto en negrita, escríbelo entre dos asteriscos (**) o dos guiones bajos (__):
**Esto es negrita**
|
Esto es negrita |
__Esto también es negrita__
|
Esto también es negrita |
Para indicar cursiva escribe el texto entre un único asterisco (*) o guión bajo (_):
*Esto es cursiva*
|
Esto es cursiva |
_Esto también es cursiva_
|
Esto también es cursiva |
Para indicar cursiva y negrita escribe el texto entre tres asteriscos (***) o guiones bajos (___):
***Esto es negrita y cursiva***
|
Esto es negrita y cursiva |
___Esto es también negrita y cursiva___
|
Esto es también negrita y cursiva |
Bloques de cita
Para indentar un texto utiliza el signo 'mayor que' (>) antes de cada línea que forme parte de la cita.
> Esto es parte de un bloque de cita.> Esto es parte del mismo bloque de cita.
|
Esto es parte de un bloque de cita. |
En lugar de ponerlo delante de cada línea puedes ponerlo al principio y al final del bloque usando un salto de línea.
> Esto es parte de un bloque de cita.Esto continúa el bloque incluso aunque no hay símbolo 'mayor que'.La línea en blanco finaliza el bloque.
|
Esto es parte de un bloque de cita. La línea en blanco finaliza el bloque. |
Listas
Para crear una lista numerada con Markdown, escribe delante de cada elemento de la lista un prefijo con un número, un punto y un espacio. El número que utilices no importa.
1. Elemento 12. Elemento 23. Elemento 3
|
|
Para crear una lista de puntos, escribe cada elemento de la lista con el prefijo asterisco (*).
* Un elemento de la lista* Otro elemento de la lista* El tercer elemento de la lista
|
|
Mucho más
La sintaxis de Markdown permite muchas más cosas además de las descritas aquí. Pero éstas cubren muchas de las necesidades habituales. Para saber más del formato Markdown puedes ir a la página de Markdown donde empezó todo (en inglés).