Markdown

Desde hace un tiempo estoy usando Markdown para generar mi documentación interna, además de crear los artículos del blog y las noticias de la web.

Qué es Markdown

En un principio, la idea de sus creadores era crear una alternativa a HTML, pero termino mutando. Markdown nos permite aprovechar las ventajas del texto plano, sin tener que renunciar al formato, pero sí a todas las complicaciones derivadas del mismo que pueden surgir cuando lo trasladamos a la web. Markdown fue creado originalmente por John Gruber, con ayuda de Aaron Swartz, con el propósito de crear un documento de texto plano fácil de escribir y fácil de leer, y que pudiera convertirse de forma sencilla y válida a XHTML.

La mejor descripción de lo que es Markdown está en la web de Markdown de John Gruber:

Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).

Thus, “Markdown” is two things: (1) a plain text formatting syntax; and (2) a software tool, written in Perl, that converts the plain text formatting to HTML. See the Syntax page for details pertaining to Markdown’s formatting syntax. You can try it out, right now, using the online Dingus.

The overriding design goal for Markdown’s formatting syntax is to make it as readable as possible. The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions. While Markdown’s syntax has been influenced by several existing text-to-HTML filters, the single biggest source of inspiration for Markdown’s syntax is the format of plain text email.

¿Por que uso Markdown?

Markdown me permite crear documentos de forma rápida, simple y que se visualizan de la misma forma en todos los sistemas operativos. Además de que si los guardo en un sistema de control de versiones puedo ver más facilmente los cambios que he realizado sobre estos.

Otra de las ventajas es el tamaño, al ser un fichero de texto el tamaño es muy reducido.

Aplicaciones que utilizo

Las aplicaciones que uso para crear y modificar los documentos en Markdown son los siguientes:

Aplicaciones de escritorio

Para el escritorio uso las siguientes:

Haroopad

De todos los editores que he encontrado es el que más me gusta, considero que es el más completo de los que he visto. Las características que han hecho que lo elija son las siguientes:

  • Es multiplataforma.
  • De fácil manejo.
  • Intiutivo.
  • Me permite tener varios estilos de texto

Este editor lo uso para documentos que no sean muy grandes y puedan estar en un sólo fichero.

Gitbook

Es el mejor editor que he encontrado para crear documentos grandes, ya que permite que cada capítulo sea un documento por separado, además de que después permite que se genere una web, un pdf o un ebook con la estructura que se le ha dado al documento. Además me permite publicar dentro de su plataforma para poder compartir los documentos. Este es el que utilizo para publicar en blog en formato ebook.

En estos momentos la única pega que tiene es que el editor de escritorio está descontinuado, pero es completamente funcional.

Aplicaciones online

Este es el punto en el que aún no me he decidido, por ahora uso indistintamente uno de estos dos editores:

  • Stackedit: este me permite publicar en el blog directamente, además de que pueden cambiarse los estilos de impresión.
  • Markable: de este me gusta más la previsualización, el tamaño de letras es menor y te permite ver mejor el documento resultante.

Plugins navegadores

Para los navegadores uso un plugin que se llama Markdown Here. Este me permite introducir el texto en formato Markdown en una casilla de texto y después convertirlo, aplicandole el estilo que se le ha configurado al plugin. Sólo tiene un estilo, pero es completamente modificable.

Página oficial

Entradas de blogs interesantes:

Markdown: qué es y cómo aprovecharlo
Markdown, la mejor opción para crear contenidos web
Learning Markdown: Write For The Web, Faster
whatismarkdown.com

Editores:

Haroopad
Gitbook
Stackedit
Markable
Markdown Here

results matching ""

    No results matching ""