Markdown : Cómo Empezar En 10 Minutos

Una guía para el popular formato Markdown de github

by Date: 18-08-2016 markdown blogging git


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
  1. Item
  2. Item
  3. Item
  4. 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
    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
  • *

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

 
by Date: 18-08-2016 markdown blogging git visitas : 1585