Skip to content

Instantly share code, notes, and snippets.

@miguelgr
Created July 20, 2013 18:56
Show Gist options
  • Save miguelgr/6046080 to your computer and use it in GitHub Desktop.
Save miguelgr/6046080 to your computer and use it in GitHub Desktop.
MD:Markdown-index

MARKDOWN

Autor: John Gruber y Aaron Swartz

Fecha: 25 Marzo 2004

Formato: .md

  1. ¿Qué es Markdown? Una breve introducción.
  2. Dingus y otras aplicaciones web.
  3. GFM(Github Flavoured Markdown).
  4. Markdown here! Escribe emails de impacto.
  5. Markdown en tus editores: Sublime Text y Vim.
  6. Multimarkdown cumple con todo.

¿Qué es Markdown? Una breve introducción

Markdown es un lenguaje de marcado originalmente creado por John Gruber y contribuciones de Aaron Swartz que permite escribir texto fácil de leer y escribir siguiendo una sintaxis muy simple, para convertirlo en un documento HTML o XHTML estructurado.

¿Entonces, qué es realmente?

  • Un script escrito en Perl Markdown.pl que convierte texto a HTML.
  • Una sintaxis para formatear texto plano. sintaxis

Markdown se distribuye bajo licencia de código abierto BSD.

[Licencia] pl

Sitios como Github, reddit y Stack Overflow usan markdown.

Dingus y otras apliaciones web

GFM(Github Flavoured Markdown)

GitHub Flavored Markdown

Github usa lo que ellos llaman GFM (Github Flavoured Markdown). Es una versión distinta a la estandar SM(Standard Markdown) en cuanto a algunas funcionalidades.

  • Newlines: puedes escribir párrafos de dos lineas.
  • Multiple underscores: puedes_escribir_todo_junto_si_quieres
  • Syntax highlighting: coloreado para la sintaxis de muchos lenguajes de programación.
  • Mentions: puedes mencionar a un usuario utilizando el carácter @
  • Issue Autocompletion: puedes referenciar a la url para un issue, así #70
  • Tasks lists: puedes crear listas de tareas con [ ] [x]
  • Emoji autocomplete: emoticonos.
  • Code: Incluir código en un bloque con número de lineas y sintaxis coloreada.

Ellos te explican más en detalle todas sus características. Pero si alguna vez has usado Github cada vez que escribes un mensaje, un issue, comentarios ... has usado GFM.

Markdown Here! Escribe emails de impacto

Se trata de una extensión para tu navegador que te permite escribir emails alucinantes utilizando Markdown. Disponible para múltiples navegadores: Chrome, Firefox, Safari, Thunderbird, y Postbox. Con ejecutar un atajo como Ctrl+M o clicar un botón convierte a HTML con alucinantes estilos cualquier email.

Es un proyecto de código libre en el cual puedes participar con contribuciones, reportando bugs o simplemente bendiciéndolo.

Github

Sitio web

Además @adam-p tiene una excelente guia para que tengas a mano cada vez que tengas una duda sobre la sintaxis de markdown.

Mardown en tus editores Sublime y Vim

  1. Marked Bonus Pack from Marked(aplicación para MAC):
  • Usa tus estilos personales:

Guarda tus archivos CSS en la ruta dónde tengas instalada la aplicación: ~/Library/Application Support/Marked/Custom CSS

Añadelo en las preferencias de Marked en el apartado Styles.

  1. Sublime Text 2 link

Copia el fichero Marked.sublime-build en

~/Library/Application Support/Sublime Text 2/Packages/User/.

Ahora en Tools en tu menú de Sublime tendrás Marked en la lista Build Systems Cuando hayas seleccionado Marked como tu Build System. Ejectua: Command-B Esto mostrará una previsualicación de documento md en HTML y se actualizará cada vez que escribas algun cambio.

  • Marked te permite exportar un fichero .md a HTML, PDF, RTF.
  • Marked te pemite usar GM aquí
  1. Markdown Preview (Previsualización en el navegador. También puedes usar Live Reload):

  2. Syntax HighLighting:

Mi configuración de Sublime para escribir markdown:

Uso el tema iPlastic :) con este gist

También me gusta Monokai añadiendo estos diccionarios dicts al fichero file.theme

Multimarkdown (MDD)

Si algo se te resistía con Markdown, pruébalo.

Se trata de un ligero lenguaje de marcado creado por Fletcher T. Penney y basado en Markdown. Soporta más formatos e implementa algunas funcionalidades que no añade la sintaxis orginal de Markdown.

Estas son algunas de las funcionalidades:

  • Notas de pie
  • Tablas
  • Citas y bibliografía
  • Soporte para matemáticas (puedes escribir funciones y ecuaciones)
  • Tipografía para multiples lenguajes
  • Atributos en las imágenes
  • Captions para tus imágenes y tablas
  • Definicion de listas
  • Metadata (ejemplo: título, autor, fecha, etc.)

Guía de la sintaxis

Markdown.IO

http://wiki.markdown.io/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment