- Propósito: Aprender sobre Markdown y ubicarlo entre otros formatos ligeros para documentar y compartir datos.
- Ejercicio práctico: Crear un Etherpad en Markdown y compartirlo con los demás talleristas.
- Prerequisitos:
- Lección: Etherpad.
Introducción
Markdown es un lenguaje de etiquetamiento ligero y es, en varias métricas, el más popular. Vamos a deconstruir las dos partes de esta explicación.
Un lenguaje de etiquetamiento ligero, es una forma de representar la estructura y presentación de un texto acompánandolo por un conjunto de marcas sencillas en su contenido, por ejemplo, colocar un guión bajo alrededor de una palabra quiere decir que esta en cursivas (así) y rodearla por dos asteriscos, quiere decir que está en negrillas (de este modo). Lo anterior permite escribir documentos de manera fluida.
Es popular porque es usado en sitios de alto tráfico donde se crean permanentemente contenidos y se ha migrado desde ahí a poblaciones más específicas. Por ejemplo:
- StackOverflow.
- GitHub.
- Pandoc: Nuestra variante de Markdown.
- Schorlarly Markdown.
- [Annotated Markdown].
Hay esfuerzos de hacer publicación e investigación transparente y reproducible usando Markdown. Gracias a ellos, se pueden producir textos extremadamente complejos, sólo usando una variante de Markdown. Por ejemplo en la comunidad de Grafoscopio hemos producido el Manual de Periodismo de Datos y los Pasos para una Bibilioteca Digital de Bogotá. Y además hay canales y comunidades referidas al uso de alguna variante de Markdown para hacer dichos investigación reproducible como el canal de Nicholas Cifuentes-Goodbody.
En contraste, existen varios lenguajes de etiquetamiento "pesado" usados ampliamente, pero engorrosos para ejercicios de memoria y escritura fluida, como:
Y hay lenguajes llamados de serialización de datos, que sirven para describir la estructura de datos de un modelo y comunitarla entre diferentes sistemas de información, que tambien empiezan a tener tendencia hacia lo ligero, entre ellos:
- YAML.
- JSON (Este lenguaje es el que se usará al exportar los datos de Twitter para el data selfie).
- TOML.
- RAML ).
- STON (Inspirado en JSON, pero para Smalltalk).
Tanto los lenguajes ligeros de etiquetamiento y de serialización de datos como los "pesados" pueden ser combinados.
"La notación inadecuada lo hace pensar a uno inadecuadamente"
Enlaces:
- Lenguages de etiquetamiento ligero:
- En Wikipedia (inglés).
- En Wikipedia (español).
- Markdown Tutorial.
- Editor de Markdown interactivo en línea.
Ejercicio:
- Visitar los enlaces de la sección anterior, leerlos y crea un etherpad, usando Markdown,
- Pegar el contenido del etherpad en StackEdit y ver cómo quedo.
- Si estás en una Data Week o Data Roda, comparte el enlace de tu pad con los demas participantes, usando el etherpad de la sesión del día.