Markdown

Bueno en esta oportunidad quiero comentarles sobre Markdown

Markdown según la 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 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".

Ahora bien, no es mi intención caer en definiciones, para eso cualquier pueden ir a Wikipedia Markdown y leerlas, mi intención es mostrar a breve manera como se puede trabajar con ella; yo particularmente la estoy utilizando (a una manera rudimentaria) para escribir en este Blog.

También es importante mencionar que Markdown no sustituye la redacción de documentos HTML, solo hace más legible los documentos.

Dicho lo anterior pues manos a la obra:

Ingredientes:

1. Editor de Texto (si no se usa MardownPad)
2. Tener Markdown instalado:
   • En GNU/Debian: aptitude install markdown
   • En Windows, se puede utilizar un editor como MarkdownPad o en su defecto utilizar la versión la siguiente versión web Markdown->dingus

La escritura es realmente simple, ya que la intención de Markdown es que el texto del documento sea "legible"

Este es un ejemplo de un documento en Markdown

#Titulo de la página

##Por Carlos Ramírez

Este es un documento _de prueba_ para ver lo fácil que es redactar un documento con Markdown

###Puntos interesantes de Markdown

Estas son algunas de las características interesantes de Markdown:

1. Se puede escribir naturalmente.
2. Fácil de leer.

Si desea más información la pueden consultar en [Markdown](http://daringfireball.net/projects/markdown/)

Al aplicar Markdown queda así:

Titulo de la página

Por Carlos Ramírez

Este es un documento de prueba para ver lo fácil que es redactar un documento con Markdown

Puntos interesantes de Markdown

Estas son algunas de las características interesantes de Markdown:

1. Se puede escribir naturalmente.
2. Fácil de leer.

Si desea más información la pueden consultar en Markdown

El documento resultante es bastante legible, la relevancia es la siguiente:

El carácter '#' significa un titulo 1 (h1), si queremos un titulo 2 solo tenemos que incrementar el nivel de '#' a dos es decir '##' y así sucesivamente.

Un enlace se construye de la forma: [Texto del enlace](url)

Es posible también construir enlaces con referencias si se van a colocar más de un enlace:

Ejemplo:

[Texto][referencia]

y más adelante

[referencia]: http://algunaurl.com

Eso se encargaría de hacer la referencia correcta, lo bueno de este método es que si planeas hacer la misma referencia en varios lugares solo redactas la referencia una vez y la utilizas.

Lo otro que se puede ver es el resaltad o énfasis etiqueta <em>, para ello, solamente tenemos que encerrar lo que tenemos que resaltar entre caracteres '_' o '*' por ejemplo:

_Esta es una frase importante_

Traduce:

Esta es una frase importante

Si deseamos encerrarlo aún más solo lo encerramos dentro de dos '__' seguidos

Ejemplo:

__Esta es una frase es más importante__

Traduce:

Esta es una frase importante

Para hacer una lista no ordenada, comienza cada línea con el carácter '*', ejemplo:

* Elemento 1
* Elemento 2

Traduce:

• Elemento 1
• Elemento 2

para hacer una lista ordenada, basta con comenzar a enumerarla así:

1. Elemento 1
2. Elemento 2 

(También se puede repetir el número 1, pero la idea es hacer el documento legible).

Traduce:

1. Elemento 1
2. Elemento 2

¿Qué otras cosas puedo hacer?

Se pueden colocar imágenes:

![Texto Alterno](/ruta/a/imagen.jpg "Titulo")

Se pueden hacer listas ordenadas utilizando el carácter '-'

Para terminar, si estan en Windows, utilicen MarkdownPad u una vez terminen de escribir seleccionen todo el texto y haga CTRL+SHIFT+C para copiar el html generado.

En Linux, ejecuten simplemente markdown nombre-archivo y generara la salida html (probablemente necesitarán redirigir la salida utilizando un markdown nombre-archivo > archivo.html)

Ahora para aclarar cualquier duda, ¿Por qué estoy utilizando Markdown y no el editor WYSIWYG integrado del blog?

La razón es simple, los editores WYSIWYG, en el afán de facilitar las cosas generan demasiado texto inútil, una cantidad de etiquetas <div> o etiquetas <span> innecesarias; al trabajar de esta manera obtengo dos ventajas, la primera es que puedo incluso desde mi teléfono ir editando un post y entender que estoy editando, y la segunda, básicamente no me gusta saber que hay una cantidad de HTML generado en mi blog sin necesidad.

Saludos.