Una guía para el popular formato Markdown de github
Markdown es un lenguaje de marcado ligero, convertido en un método de escritura cada vez más utilizado por blogueros y para escribir contenido en general.
Permite escribir sin distracciones y de una forma rápida, sin prestar atención al formato, esto no significa que renunciemos a él.
Sino que la forma de aplicarlo es la más sencilla hasta ahora inventada: Permite añadir formatos tales como negritas, cursivas o enlaces, utilizando simplemente texto plano.
En este post veremos los elementos más comunes para construir un documento con Markdown y empezar a utilizarlo ¡desde ya!.
Sintaxis Markdown
Títulos
Existen dos formas de escribir títulos subrayando con = para h1 y con - para h2.
También es posible marcar el título con * al principio del texto. No hay límite de niveles (h1..h6).
*** Markdown code ***
*********************
Título 1
==
Título 2
-
### Título 3 #
#### Título 4
Da como resultado
Título 1
Título 2
Título 3
Título 4
Parráfos
Un párrafo se indica con un salto de línea.
Soy un párrafo
Soy otro párrafo
Enfásis
negritas, cursivas ,o overlined
**negritas**, *cursivas* ,**bold** or ~~tachado~~
Cita
Indicamos una cita con >.
*** Markdown code ***
*********************
> Esta es tu vida. Haz lo que amas, y hazlo a menudo. Si no te gusta
> algo, cámbialo.
Esta es tu vida. Haz lo que amas, y hazlo a menudo. Si no te gusta
algo, cámbialo.
Listas no ordenadas
Para crear una lista podemos empezar con * , -, o +. Aunque las tres funcionan hay que tratar de ser consistente y utilizar siempre la misma.
*** Markdown code ***
*********************
* item
* item
* item
-
+ item
+ item
+ item
-
- item
- item
- item
Cualquier resultado dará una lista no ordenada.
- item
- item
- item
Listas ordenadas
El número no importa. Se ordenan automáticamente con nº seguido de . (punto).
*** Markdown code ***
*********************
1. Item
1234. Item
3. Item
4. Item
- Item
- Item
- Item
- Item
Ejemplo de lista anidada
* An unordered list item
* A nested unordered list item
* Another list item
1. The first nested ordered list item
2. A second nested ordered list item
* A nested unordered list
3. This is the last nested ordered list item
* The last unordered list item
- An unordered list item
- A nested unordered list item
- Another list item
- The first nested ordered list item
- A second nested ordered list item
- A nested unordered list
- This is the last nested ordered list item
- The last unordered list item
- *
Links
Entre corchetes va el texto que veremos, entre paréntesis la url y entre comillas el title. Un ejemplo
Un [ejemplo](http://url.com/ "Title")
Bloque de código
Para insertar un bloque de código , saltamos una línea como en el parráfo y luego indentamos usando 4 espacios o la tabulación. Seguiremos en el mismo bloque hasta que quitemos la indentación
*** Markdown code ***
*********************
hola min soy un bloque de codigo
Y ya sabemos que para aprender lo mejor es practicar. Un editor online donde podemos empezar a trabajar con markdown es stackedit.io