Escribiendo en Markdown...

Comments

Como crear sencillas publicaciones utilizando el formato Markdown.

Guía de Markdown

Esta guía le puede servir como un marco de referencia a la hora de crear publicaciones en formato Markdown.

No obstante, le sugerimos ampliar dicha lectura con otras fuentes bibliográficas.

Elementos de bloque

Encabezados

Las almohadillas # nos permiten crear encabezados o titulos. Se debe añadir una almohadilla por cada nivel.

# Este es un encabezado 1

Este es un encabezado 1

## Este es un encabezado 2

Este es un encabezado 2

### Este es un encabezado 3

Este es un encabezado 3

#### Este es un encabezado 4

Este es un encabezado 4

##### Este es un encabezado 5
Este es un encabezado 5
###### Este es un encabezado 6
Este es un encabezado 6

Existe otra variante para crear encabezados, sin embargo, esta limitado a dos niveles.

Consiste en subrayar los encabezados con el símbolo = (para el encabezado 1), o con guiones - para el encabezado 2.

Esto sería un encabezado 1
===
Esto sería un encabezado 2
—-

No existe un número concreto = o - que necesites escribir para que esto funcione, incluso bastaría con uno.

Citas

Las citas se pueden generar utilizando el comando > (mayor que) al comienzo del bloque.

> Si no lo puedes explicar de forma simple, no lo entiendes suficientemente bien  - Albert Einstein

Si no lo puedes explicar de forma simple, no lo entiendes suficientemente bien  - Albert Einstein

Listas

A diferencia de lo que ocurre en HTML, generar listas en Markdown es extremadamente sencillo. Puedes encontrarte con dos tipos.

Listas desordenadas

Para crear listas desordenadas utiliza * asteriscos, - guiones, o + símbolo de suma.

- Elemento de lista 1
- Elemento de lista 2
* Elemento de lista 3
* Elemento de lista 4
+ Elemento de lista 5
+ Elemento de lista 6
  • Elemento de lista 1
  • Elemento de lista 2
  • Elemento de lista 3
  • Elemento de lista 4
  • Elemento de lista 5
  • Elemento de lista 6

Para generar listas anidadas dentro de otras, simplemente tendrás que añadir cuatro espacios en blanco antes del siguiente *, - o +.

- Elemento de lista 1
- Elemento de lista 2
  - Elemento de lista 3
  - Elemento de lista 4
    - Elemento de lista 5
    - Elemento de lista 6
  • Elemento de lista 1
  • Elemento de lista 2Elemento de lista 3Elemento de lista 4Elemento de lista 5Elemento de lista 6
  • Elemento de lista 3
  • Elemento de lista 4
  • Elemento de lista 5
  • Elemento de lista 6

Listas ordenadas

Para crear listas ordenadas debes utilizar la sintaxis de tipo: "número". 1.. Al igual que ocurre con las listas desordenadas, también podrás anidarlas o combinarlas.

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
  1. Elemento de lista 1
  2. Elemento de lista 2Elemento de lista 3Elemento de lista 4Elemento de lista 5Elemento de lista 6
  3. Elemento de lista 3
  4. Elemento de lista 4Elemento de lista 5Elemento de lista 6
  5. Elemento de lista 5
  6. Elemento de lista 6

Códigos de bloque

Si quieres crear un bloque entero que contenga código. Lo único que tienes que hacer es encerrar dicho párrafo entre dos líneas formadas por tres ~ virgulillas.

~~~
Creando códigos de bloque.
Puedes añadir tantas líneas y párrafos como quieras.  
~~~
Creando códigos de bloque.
Puedes añadir tantas líneas y párrafos como quieras.

Elementos de línea

Énfasis (negritas y cursivas)

Markdown utiliza asteriscos o guiones bajos para enfatizar.

Simplemente tendrás que envolver palabras o textos en éstos símbolos para conseguir cursivas o negritas.

MARKDOWNRESULTADO
*cursiva*cursiva
_cursiva_cursiva
**negrita**negrita
__negrita__negrita

Por supuesto si quieres utilizar los dos tipos de énfasis no tienes más que combinar la sintaxis, envolviendo la palabra entre tres asteriscos o tres guiones bajos.

MARKDOWNRESULTADO
***cursiva y negrita***cursiva y negrita
___cursiva y negrita___cursiva y negrita

Links o enlaces

Añadir enlaces a una publicación, más que común, hoy en día es algo casi obligatorio. Con Markdown tendrás varias formas de hacerlo.

Links o enlaces en línea

Son los enlaces de toda la vida. Como su nombre indica, se encuentran en línea con el texto.

Se crean escribiendo la palabra o texto enlazada entre [] corchetes, y el link en cuestión entre () paréntesis.

MARKDOWNRESULTADO
  [enlace en línea](https://www.webxander.com)  enlace en línea

Links o enlaces como referencia

La desventaja del método anterior, es que si utilizas links demasiado complejos o largos pueden dificultarte la lectura de tu texto.

Para solucionarlo y crear tu contenido de una manera más ordenada puedes generar enlaces de referencia.

Esto quiere decir que en tu texto enlazarás palabras o códigos concretos (formados por letras y/o números), que en otro lugar más apartado de tu documento tendrás definidos como determinadas URL.

[nombre que quieres darle a tu enlace][nombre de tu referencia]

[nombre de tu referencia]: http:www.tuenlace.com

Esto se ve más claro con un ejemplo.

Me llamo Alejandro Cayssials y tengo un blog sobre [desarrollo web][blog].

En dicha [web][blog] recopilo artículos sobre todo lo relacionado con programacion, ciencia y tecnologia.

[blog]: https://webxander.com/articles/

La referencia [blog] puede estar incluida en cualquier parte del documento, así puedes organizarte mejor y de una manera más limpia, recopilando todas tus referencias en un mismo lugar

Además como ves a continuación, esta referencia no se incluye en el resultado final, sino que desaparece.

Me llamo Alejandro Cayssials y tengo un blog sobre desarrollo web.

En dicha web recopilo artículos sobre todo lo relacionado con programacion, ciencia y tecnologia.

Links automáticos

Estos son necesarios cuando lo que quieres es mostrar una URL completa, y no un enlace enmascarado bajo una palabra o frase como ocurre con los links en línea.

Para generar links automáticos tan solo tendrás que rodearlos con los símbolos < >

\https://webxander.com\

Código

En según que tipo de publicaciones (sobre todo las de carácter técnico), necesitarás añadir pequeñas secciones donde mostrar código de otro lenguaje, atajos de teclado, o demás contenido que no debería ser tratado como tal.

Para ello tienes disponible dos alternativas.

Código puro <code>

La forma más sencilla de escribir código en Markdown es envolver el texto entre dos comillas sencillas `. Esto se corresponde con la etiqueta HTML <code>

`Esto es una línea de código`

Se verá como Esto es una línea de código

Como ves, es muy útil para introducir código dentro de la misma línea o párrafo, algo que no permite el método siguiente.

Texto preformateado <pre>

La otra manera de añadir código en Markdown es comenzar el párrafo con cuatro espacios en blanco. Esto se corresponde con la etiqueta HTML <pre>

    Esto es una línea de código

Se convierte en

Esto es una línea de código

Ojo, ¡estos espacios deberás incluirlos en cada línea que escribas! Para añadir código en bloque es mejor utilizar la sintaxis que viste anteriormente.