Markdown

Imagen alusiva al logo de Markdown

  • 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:

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:

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:

Ejercicio:

  • Visitar los enlaces de la sección anterior, leerlos y crea un etherpad, usando Markdown,
  • Leer el documento introductorio a docutopia y seguir los ejercicios
    hasta la descarga del documento creado desde el navegador.
  • Crear un pad en Docutopia (que es una instancia de docutopia), dentro del arenero.

    Para organizar la información, los pads de práctica que creemos van a estar dentro de la arenera, que tendrá esta estructura:

    subdominio.dominio.algo/categoria:pagina
    docutopia.tupale.co/arenera:<pagina>
    

    Reemplazando <pagina> por la url que queramos, por ejemplo prueba1.

    Recuerda que esta instancia soporta CommonMark, un supraconjunto de Markdown con
    características extendidas.

  • 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.

[ ^ Indice | Fossil > ]

Markdown 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. Critic Markdown. Hypothesis 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: HTML. SGML. XML. LaTeX. 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. Learn Markdown in 60 seconds Editor de Markdown interactivo en línea. Ejercicio: Visitar los enlaces de la sección anterior, leerlos y crea un etherpad, usando Markdown, Leer el documento introductorio a docutopia y seguir los ejercicios hasta la descarga del documento creado desde el navegador. Crear un pad en Docutopia (que es una instancia de docutopia), dentro del arenero. Para organizar la información, los pads de práctica que creemos van a estar dentro de la arenera, que tendrá esta estructura: subdominio.dominio.algo/categoria:pagina docutopia.tupale.co/arenera:<pagina> Reemplazando <pagina> por la url que queramos, por ejemplo prueba1. Recuerda que esta instancia soporta CommonMark, un supraconjunto de Markdown con características extendidas. 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. [ ^ Indice | Fossil > ]
{"breaks":false}