Markdown, un lenguaje de marcado ligero

A la hora de crear documentación, sobre todo en sitios como Github o Bitbucket, donde uno se acostumbra a leer muchos README, un gran porcentaje está escrito en Markdown, haciendo que Markdown se convierta en un lenguaje del día a día, por lo tanto es bueno que muchos conozcamos que es realmente este lenguaje y algunos ejemplos de su implementación.

Segun Wikipedia:

Markdown es un lenguaje de marcado ligero creado originalmente por John Gruber y Aaron Swartz que trata de conseguir la máxima legibilidad y "publicabilidad" tanto en sus forma de entrada como de salida, inspirándose en muchas convenciones existentes para marcar mensajes de correo electrónico usando texto plano. Markdown convierte el texto marcado en documentos XHTML bien formados, reemplazando el signo ‘menor que’ (‘<‘) y los ampersands por sus correspondientes referencias de entidad de caracteres.

Este lenguaje es otro legado de Aaron Swartz, y está muy extendido junto a otros lenguajes como RSS, ReStructuredText, BBCode (Usado en Cristalab), YAML, JSON y más. Pero ¿Qué hace tan especial a Markdown?

Bajo mi punto de vista, y según mi experiencia a lo largo de estos años, Markdown ha tomado fuerza y se ha convertido en un lenguaje muy extendido en las comunidades por su sencillez y fácil implementación en distintos sistemas. Markdown se ha convertido en un lenguaje muy práctico, permitiendo el uso de texto plano pero sin sacrificar el formato de texto.

Con Markdown se pueden escribir documentos y luego exportarlos a HTML sin saber HTML, además la legibilidad es mayor porque no se necesitan etiquetas de marcado al estilo XML.

Un ejemplo de un documento en Markdown

Código :

# Esto es un titulo
## Esto es un subtitulo

* Esto es una lista
* Esto es otro elemento de la lista
* [Esto es un link en una lista](http://www.cristalab.com)
* ![Imagen](http://www.foo.com/bar.jpg)

Esto en HTML:

Código :

<h1>Esto es un titulo</h1>
<h2>Esto es un subtitulo</h2>

<ul>
    <li>Esto es una lista</li>
    <li>Esto es otro elemento de la lista</li>
    <li><a href="http://www.cristalab.com">Esto es un link en una lista</a></li>
    <li><img src="http://www.foo.com/bar.jpg" alt="Imagen" /></li>
</ul>

Párrafos

Código :

Texto en cursiva: *texto en cursiva* o _texto en negrita_
Texto en negrita: **texto en negrita** o __texto en negrita__
Texto tachado: ~~texto tachado~~
Combinando texto en negrita con letras cursivas y tachado: **Este texto es en negrita, hay _cursiva_ y ~~tachado~~**

Listas numéricas

Código :

1. Primer elemento
2. Segundo elemento
  1. Sublista
  2. Sublista
3. Tercer elemento
  * Sublista desordenada

Tablas

Código :

Markdown | Foo | Bar
--- | --- | ---
*Foo* | `Bar` | **Foo**
1 | 2 | 3

Y el resultado:

Como pueden observar uno se ahorra muchos caracteres. Markdown va mucho mas allá de eso y permite hasta resaltado de sintaxis de una gran cantidad de lenguajes de programación de una manera sencilla.

Ejemplo:

Código :

```python
def main():
    print "hola mundo"
```

o en otros casos dejando un margen de 4 espacios:

Código :

    def main():
        print "hola mundo"

Yohan Graterol (@yograterol)

Enviar comentario

via Cristalab http://feeds.cristalab.com/~r/clab/~3/WSLF78Qt9WM/

Advertisements

Tags:

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: