lunes, 15 de julio de 2013

Markdown en Linux

Markdown es un lenguaje de marcado de texto liviano, muy usado hoy en día para documentar proyectos de software o incluso escribir post en un Blog.

Markdown es simple de aprender y muy fácil de escribir, en contraposición de escribir manualmente un documento en lenguaje HTML.

Pero como usarlo en Linux de un modo efectivo.


Sinopsis de Markdown

Para crear un documento markdown, sólo se necesita crear un documento de texto plano (txt) e incluir una serie de símbolos en ese texto y guardar el documento con la extensión '.md'.

En un breve recorrido por su sintaxis podemos mencionar:

Crear un título a distintos niveles:

# Mi titulo principal Generará el código html:
<h1>Mi titulo principal</h1>.

## Mi titulo secundario Generará el código html:
<h2>Mi titulo principal</h2>.

Formatear palabras

El texto **en negritas** Generará el código html:
<b>Mi titulo principal</b>.

El texto *italizado* Generará el código html:
<em>Mi titulo principal</em>.

Ofuscar la dirección de correo electrónico:

<miemail@dominio.com> generará el código html:

<a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;&#109;&#105;&#101;&#109;&#97;&#105;&#108;&#64;&#100;&#111;&#109;&#105;&#110;&#105;&#111;&#46;&#99;&#111;&#109;">&#109;&#105;&#101;&#109;&#97;&#105;&#108;&#64;&#100;&#111;&#109;&#105;&#110;&#105;&#111;&#46;&#99;&#111;&#109;</a>

Y los enlaces:

[mi pagina web](http://www.midominio.com) generará el código html:
<a href="http://www.midominio.com">mi pagina web</a>

Herramientas de markdown en Linux

Si nuestro interés es sólo convertir un documento creado en markdown, a HTML. Entonces la herramienta más directa para realizar esta tarea, sin usar ningún editor de texto, es simplemente usando el programa en Perl, llamado 'Markdown.pl'.

Usando comando de Perl Markdown.pl

Mas información acerca de Markdown.pl: http://search.cpan.org/~sekimura/Text-Markdown-Discount-0.06/xt/MarkdownXS.pl
Se puede descargar desde: http://search.cpan.org/CPAN/authors/id/S/SE/SEKIMURA/Text-Markdown-Discount-0.06.tar.gz

Este script efectuado en Perl, libera en pantalla el código html generado a partir de documento markdown. Así, que para generar un archivo HTML se debe redireccionar la salida, un ejemplo de sintáxis típico es:

perl Markdown.pl archivo_markdown.md > render_html.html

También se puede visualizar el resultado usando el Lynx:

perl Markdown.pl archivo_markdown.md | lynx stdin

En el caso que se desea un render en vivo del código markdown que vamos escribiendo estonces la herramienta que podermos usar es ReText.

Editor de texto ReText

ReText es libremente disponible en Linux, en Ubuntu para podemos instalar desde el centro de distribución Ubuntu Software Center. Las principales características de ReText son:

  • Exportación directa a código HTML.
  • Divide la ventana para ver en tiempo real de nuestro código markdown con el rendirizada en un explorador de internet.

ReText es muy liviano y simple de usar, sin duda, es lo indicado de usar en el sistema Linux.

Referencias externas de Markdown

No hay comentarios:

Publicar un comentario en la entrada