Markdown

Markdown es un lenguaje de marcado ligero creado originalmente por John Gruber [1] y Aaron Swartz [2] 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. Markdown fue implementado originariamente en Perl por Gruber, pero desde entonces ha sido traducido a multitud de lenguajes de programación, incluyendo PHP, Python, Ruby, Java y Common Lisp. Se distribuye bajo licencia BSD y se distribuye como plugin (o al menos está disponible) en diferentes sistemas de gestión de contenidos (CMS)

Ejemplos de sintaxis

Lo que sigue no es un listado exhaustivo de la sintaxis de Markdown. En muchos casos, se puede conseguir un efecto particular usando diferentes estilos de sintaxis. Véase la referencia completa de la sintaxis de Markdown para obtener más información.

Los caracteres que serían interpretados por Markdown como comandos de formateado se interpretan literalmente si se precede por una barra invertida; por ejemplo la secuencia '\*' mostraría un asterisco en lugar de empezar una sección de texto enfatizado. Un bloque de HTML crudo no se verá alterado por Markdown, pero los comandos de Markdown insertados dentro de un elemento de bloque de HTML crudo no serán procesados.

Texto con énfasis:

 *énfasis* (p.e., cursiva)

 **énfasis fuerte** (p.e., negrita)

Código:

 `código`

Listas:

 * Un elemento en una lista no ordenada
 * Otro elemento en una lista

 1. Elemento en una lista enumerada u ordenada.
 2. Otro elemento

Encabezamientos:

Los encabezamientos HTML se producen colocando un número de almohadillas ('#') antes del texto correspondiente al nivel de encabezamiento deseado (HTML ofrece hasta seis niveles), por ejemplo:

 # Encabezamiento de primer nivel

 #### Encabezamiento de cuarto nivel

Los primeros dos niveles de encabezamiento tienen una sintaxis alternativa:

 Encabezamiento de primer nivel
 ==============================

 Encabezamiento de segundo nivel
 -------------------------------

Citas:

 > Este texto aparecerá dentro de un elemento HTML de cita ('blockquote')

Enlaces:

 [Texto del enlace aquí](dirección.enlace.aquí "título del enlace aquí")

Imágenes:

 ![Texto alternativo](URL de la imagen "Título de la imagen")

Véase también

• Markdown Extra
• Lenguajes de marcas ligeros
• SmartyPants, un filtro de texto que implementa ciertos embellecimientos tipográficos, también creado por John Gruber y usado conjuntamente con Markdown.

Implementaciones

• PHP: PHP Markdown
• Python: markdown.py (de webpy.org)
• Python: python-markdown (de freewisdom.org)
• Perl: Text::Markdown
• C#: Markdown.NET
• Ruby: BlueCloth
• Java: markdownj, MarkdownPapers
• JavaScript: js-markdown (parcialmente implementado)
• Lua: markdown.lua
• MultiMarkdown, una versión en Perl de Markdown con ciertas características extra, así como otras herramentas relacionadas con Markdown.

Guías de sintaxis

• Markdown: Dingus conversor online
• cheat sheet en warpedvisions (en inglés)
• Guía Rápida de Sintaxis de Markdown (en inglés)

Conversores

• HTML a Markdown : html2text (en Python), XHTML-to-Markdown XSLT (hoja de estilo, sólo funciona con XHTML)
• De otros formatos a Markdown: odt2txt (un conversor en Python que traduce documentos de texto OpenDocument en Markdown)

Software de publicación en Web que usa Markdown

• Wikis: Infogami, Instiki, Oddmuse (mediante módulo externo), DokuWiki (mediante plugin)
• Weblog: Typo, Blojsom (mediante plugin), Wordpress (mediante plugin), Movable Type (mediante plugin)
• CMS: Drupal (mediante plugin)

Editores de texto con soporte

• Editores de propósito general: TextMate
• Editores de blogs: Ecto, MarsEdit