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.
Esto es parte del mismo 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.
Esto continúa el bloque incluso aunque no hay símbolo 'mayor que'.

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 1
2. Elemento 2
3. Elemento 3
  1. Elemento 1
  2. Elemento 2
  3. 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
  • 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).

ARCOTEL - DSI - 2015