Sintaxis de Markdown

Inicio  Anterior  Siguiente

Referencia en https://joedicastro.com/pages/markdown.html

Cabeceras

Los encabezamientos HTML se producen colocando un número determinado de almohadillas #antes del texto correspondiente al nivel de encabezamiento deseado (HTML ofrece hasta seis niveles). Los encabezamientos posibles se pueden ver en la siguiente tabla:

Tecleas

Obtienes

# Esto es un H1

Esto es un H1

## Esto es un H2

Esto es un H2

### Esto es un H3

Esto es un H3

#### Esto es un H4

Esto es un H4

##### Esto es un H5

Esto es un H5

###### Esto es un H6

Esto es un H6

Se puede encerrar cada encabezado entre almohadillas, por motivos puramente estéticos, porque no es necesario en absoluto, es decir, se puede hacer esto:

Tecleas

Obtienes

### Esto es un H3 ###

Esto es un H3

Para los encabezamientos de los dos primeros niveles existe también otra manera de hacer lo mismo, que sería la siguiente:

Tecleas

Obtienes

Esto es un H1

=============

Esto es un H1

Esto es un H2

-------------

Esto es un H2

Es decir para los encabezamientos principales se subraya el texto con el signo igual. Para los encabezamientos de segundo nivel se utilizan guiones para subrayar. Es indiferente el número de signos iguales o guiones que se empleen, con uno es suficiente.

Enlaces

Existen también dos maneras de crear enlaces, se pueden ver en la siguiente tabla:

Tecleas

Obtienes

[Con titulo](http://joedicastro.com "titulo")

Con titulo

[Sin titulo](http://joedicastro.com)

Sin titulo

[Enlace 1][1], [Enlace 2][2], [Enlace 3][3]

 

 [1]: http://joedicastro.com/consejos

 [2]: http://joedicastro.com/consejos "Consejos"

 [3]: http://joedicastro.com/

Enlace 1Enlace 2Enlace 3

Existe una manera adicional de crear enlaces automáticos para direcciones URL, simplemente encerrarla entre los caracteres menor < que y mayor que >:

Tecleas

Obtienes

<http://joedicastro.com>

http://joedicastro.com

Párrafos

Para crear párrafos se deja una línea en blanco. De este modo.

Tecleas

Obtienes

Este es el primer párrafo.

 

Este es el segundo párrafo.

Este es el primer párrafo.

Este es el segundo párrafo

Para crear un salto de línea dentro de un párrafo, simplemente se dejan dos espacios al final de la última palabra de esa línea, de este modo:

Tecleas

Obtienes

Esta es la primera línea

y este es el salto de línea.

Esta es la primera línea
y este es el salto de línea.

Formato

El formato básico del texto, es decir negritas y cursiva, se pueden realizar de varias maneras:

Tecleas

Obtienes

**Esto es negrita**

Esto es negrita

__Esto también es negrita__

Esto también es negrita

*Esto es cursiva*

Esto es cursiva

_Esto también es cursiva_

Esto también es cursiva

***Esto es negrita y cursiva***

Esto es negrita y cursiva

___Esto también es negrita y cursiva___

Esto también es negrita y cursiva

Se pueden emplear indistintamente tanto el asterisco * como el guión bajo _ siempre y cuando no se mezclen y lo que determina el formato es el número de ellos antes y después del bloque de texto a formatear. Uno es cursiva, dos es negrita, y tres ambas a la vez, así de sencillo.

Citas

Para crear bloques de cita, se emplea el carácter mayor que > antes del bloque de texto. En la siguiente tabla se pueden ver las opciones para crearlos.

Tecleas

Obtienes

Esto es una línea normal

 

> Esto es parte de un bloque de cita.

> Esto es parte del mismo bloque de cita.

Esto es una línea normal

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 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.

Esto es una línea normal

 

> Esto es parte de un bloque de cita.

> Esto es parte del mismo bloque de cita.

>

> > Esto es otro bloque de cita anidado.

> > Esto es parte del bloque anidado.

>

> Esto es parte del bloque de cita de primer nivel.

Esto es una línea normal

Esto es parte de un bloque de cita. Esto es parte del mismo bloque de cita.

Esto es otro bloque de cita anidado. Esto es parte del bloque anidado.

Esto es parte del bloque de cita de primer nivel.

Listas

Markdown permite crear dos tipos de listas, ordenadas y desordenadas, es decir numeradas o listas de puntos. Para distinguir los tipos y como se crean, nada mejor que verlo con ejemplos:

Tecleas

Obtienes

Lista numerada (ordenada)

 

1. Este es el primer elemento

2. Este es el segundo elemento

3. Este es el tercer elemento

 

Lista numerada (ordenada)

1.Este es el primer elemento
2.Este es el segundo elemento
3.Este es el tercer elemento

Lista de puntos (desordenada)

 

* Un elemento de la lista

* Otro elemento de la lista

* El tercer elemento de la lista

 

Lista de puntos (desordenada)

Un elemento de la lista
Otro elemento de la lista
El tercer elemento de la lista

Se pueden emplear también + y - en vez de *

 

* Un elemento de la lista

+ Otro elemento de la lista

- El tercer elemento de la lista

 

Se pueden emplear también + y - en vez de *

Un elemento de la lista
Otro elemento de la lista
El tercer elemento de la lista

Se pueden mezclar distintos tipos de listas y anidar unas dentro de otras.

 

1. Esto es una lista ordenada

2. Segundo elemento de la lista ordenada

   1. Esta es una lista ordenada anidada dentro de otra

       * Lista desordenada anidada a tercer nivel

       * Segundo elemento de esta lista

   2. Este es el segundo elemento de la lista ordenada anidada

 

Se pueden mezclar distintos tipos de listas y anidar unas dentro de otras.

1.Esto es una lista ordenada
2.Segundo elemento de la lista ordenada
1.Esta es una lista ordenada anidada dentro de otra
Lista desordenada anidada a tercer nivel
Segundo elemento de esta lista
2.Este es el segundo elemento de la lista ordenada anidada

Listas de definiciones

Se pueden crear lista de definiciones, que están compuestas de términos y las definiciones de los mismos, como si fuera un diccionario. Su creación es muy sencilla:

Tecleas

Obtienes

Primer termino

: Primera definición

 

Segundo termino

: Segunda definición

Primer término

Primera definición

Segundo término

Segunda definición

Se pueden aplicar más de una definición a un termino

 

Primer termino

: Primera definición

: Segunda definición

 

Segundo termino

: Segunda definición

Se pueden aplicar más de una definición a un termino

Primer término

Primera definición

Segunda definición

Segundo término

Segunda definición

Se pueden aplicar más de un termino a una definición

 

Primer termino

Segundo termino

: Primera definición

 

Tercer termino

: Segunda definición

Se pueden aplicar más de una definición a un termino

Primer término

Segundo término

Primera definición

Tercer término

Segunda definición

Si dejamos una línea en blanco entre el termino y la definición,

se creara un párrafo para la definición.

 

Primer termino

: Primera definición

 

Segundo termino

: Segunda definición

Si dejamos una línea en blanco entre el termino y la definición, se creara un párrafo para la definición.

Primer termino

Primera definición

Segundo termino

Segunda definición

Una definición puede constar de varios párrafos.

 

Primer termino

: Primera definición

 

Segundo párrafo de la primera definición

 

Segundo termino

: Segunda definición

Una definición puede constar de varios párrafos.

Primer término

Primera definición

Segundo párrafo de la primera definición

Segundo término

Segunda definición

Imágenes

La manera de enlazar imágenes es básicamente la misma de crear enlaces, con un única diferencia, se añade el carácter exclamación ! al principio de la pareja de corchetes que definen el nombre del enlace. Ejemplos:

Tecleas

Obtienes

![Con titulo](pictures/avatar.png "titulo")

![Sin titulo](pictures/avatar.png)

![Imagen 1][1]  ![Imagen 2][2]

 

 [1]: pictures/avatar.png

 [2]: pictures/scaphandre.png "scaphandre"

 

Tablas

Crear tablas es sumamente sencillo, simplemente debemos indicar cuales son los elementos de la cabecera y separar los campos con el símbolo |

Tecleas

Obtienes

Cabecera A | Cabecera B

-- | --

Campo A0 | Campo B0

Campo A1 | Campo B1

Cabecera A

Cabecera B

Campo A0

Campo B0

Campo A1

Campo B1

Si se desea, por estética, se pueden alinear las columnas e incluso comenzar y finalizar las filas con el símbolo |, pero no es en absoluto necesario.

Tecleas

Obtienes

| Cabecera A | Cabecera B |

| ---------- | ---------- |

| Campo A0   | Campo B0   |

| Campo A1   | Campo B1   |

 

Cabecera A

Cabecera B

Campo A0

Campo B0

Campo A1

Campo B1

Se puede especificar la alineación de cada columna mediante la adición de dos puntos a las líneas de separación. Dos puntos a la izquierda de la línea de separación hará que la columna esté alineada a la izquierda, dos puntos a la derecha de la línea hará que la columna esté alineada a la derecha, dos puntos en ambos lados significa que la columna se alinea al centro.

Tecleas

Obtienes

| Elemento | Cantidad | Precio |

| :------- | :------: | -----: |

| Item 1   | 15       | 150€   |

| Item 2   | 3250     | 23,65€ |

 

Elemento

Cantidad

Precio

Item 1

15

150€

Item 2

3250

23,65€

Código

Se pueden crear bloques de código para albergar extractos de código fuente de un lenguaje de programación o para reproducir literalmente cualquier tipo de texto sin que sea interpretado por markdown. Lo único necesario es que cada línea de este bloque empiece por al menos 4 espacios o 1 tabulado.

De todos modos, es mucho más recomendable para estas tareas emplear el resaltado de código que se especifica en esta sección.

Tecleas

Obtienes

Esto es un párrafo normal.

   Esto es un párrafo de código.

 

Esto es un párrafo normal.

Esto es un párrafo de código.

Existe otro modo de crear un bloque de código, encerrándolo entre dos líneas formadas por tres o más caracteres tilde ~

Tecleas

Obtienes

Esto es un párrafo normal

 

~~~

Esto es un párrafo de código.

~~~

Esto es un párrafo normal.

Esto es un párrafo de código.

Por último existe una opción para resaltar pequeños trozos de código dentro de párrafos de texto normal. Para lograr esto debemos encerrar el código entre dos acentos graves `.

Tecleas

Obtienes

Esto es un párrafo normal, con un trozo de código, `import this` insertado en el medio del mismo.

 

Esto es un párrafo normal, con un trozo de código, import this insertado en el medio del mismo.

Líneas Horizontales

Para crear líneas horizontales se debe crear una línea rodeada de líneas en blanco y compuesta por 3 o más símbolos, que pueden ser guiones, asteriscos o guiones bajos. Pueden crearse espacios entre estos caracteres si así se desea por estética.

Tecleas

Obtienes

 

***

 

 


 

- - -

 

 


 

___

 

 


Escapar carácteres

¿Que ocurre cuando queremos mostrar un carácter que markdown emplea para el marcado? Es posible que dependiendo de donde y como se emplee este símbolo, sea interpretado por markdown y nos estropee el formato del texto. En este caso lo que se necesita es escapar el carácter con el símbolo backslash \ En esta tabla se muestran los símbolos que pueden ser escapados por markdown.

Tecleas

Obtienes

\\ \` \* \_  \{\} \[\] \(\) \# \+ \- \. \! \: \|

\ ` * _ {} [] () # + - . ! : |

Notas a pie de página

Las notas de página se crean de una manera muy sencilla en Markdown. Cada nota de pie de página se compone de dos elementos: un marcador al lado del texto que se convierte en un superíndice y de una definición que se puede colocar en una lista de notas al pie al final de documento. Ejemplo:

Tecleas

Obtienes

Esto es un texto con nota al pie [^1]

 

[^1]: Esto es una nota al pie de página.

 

Esto es un texto con nota al pie 1

1.Esto es una nota al pie de página. ↩

Las definiciones de la nota al pie se pueden encontrar en cualquier parte del documento, pero las notas siempre se mostrarán en el orden en que están vinculados en el texto. Hay que tener en cuenta que no puede hacer dos enlaces a la misma nota al pie: si se intenta, la referencia de la nota segunda quedará como texto sin formato.

Cada marcador de nota debe tener un nombre distinto. Ese nombre se utiliza para vincular la nota a la que hace referencia a las definiciones de la nota, pero no tiene ningún efecto sobre la numeración de las notas al pie. Los nombres pueden contener cualquier carácter válido que sirva para la una Identificación de un atributo HTML (es decir, que cumpla con la expresión regular [A-Za-z][-A-Za-z0-9_:.]*), no tienen porque ser necesariamente números. Ejemplo:

Tecleas

Obtienes

Esto es un texto con nota al pie [^nota1] y esta es otra nota [^nota2]

 

[^nota1]: Esto es una nota al pie de página.

[^nota2]: Esto es la segunda nota al pie.

 

Esto es un texto con nota al pie 1 y esta es otra nota 2

1.Esto es una nota al pie de página. 
2.Esto es la segunda nota al pie. 

Abreviaturas

Para crear abreviaturas HTML lo único necesario es crear una lista de ellas (normalmente al final del texto) y en cualquier lugar del texto que aparezca la abreviatura se aplicará automáticamente. Las listas de abreviaturas se crean como las listas de enlaces, pero precedidas por un asterisco.

Tecleas

Obtienes

La especificación HTML es mantenida por el W3C.

 

*[HTML]: Hyper Text Markup Language

*[W3C]:  World Wide Web Consortium

 

La especificación HTML es mantenida por el W3C.

Las abreviaturas son sensibles a mayúsculas, por lo que hay que tenerlo en cuenta. Se pueden crear abreviaturas de más de una palabra.