variantes-flavors-de-markdown

Variantes y Flavors de Markdown

A lo largo de los años, se han desarrollado varias extensiones o variantes para mejorar y adaptar Markdown a diferentes necesidades y plataformas.

A veces a estas variantes se les denomina “flavor” (sabor en ingles). Algunas de las principales variantes de Markdown, son CommonMark o GitHub Flavored Markdown (GFM).

Estas variantes modifican el estándard (que, está un poco “en tierra de nadie”) y añaden funcionalidades, o normalizan algunas de las existentes.

En cualquier caso es importante saber qué variantes existen y sobre todo, cuál estamos usando, o podemos usar una funcionalidad que no esté implementada en esa plataforma.

CommonMark

CommonMark es una especificación de Markdown que se desarrolló para abordar la falta de estandarización y coherencia en las implementaciones de Markdown existentes.

Su objetivo es proporcionar una definición unificada y clara del lenguaje, asegurando que el contenido se interprete de manera consistente en diferentes plataformas y aplicaciones.

Características principales de CommonMark,

  • Estandarización: CommonMark proporciona una especificación detallada y estandarizada que define cómo debe comportarse Markdown en diversas situaciones.
  • Compatibilidad: Ofrece una base sólida para el desarrollo de extensiones y variantes adicionales, asegurando que el contenido se muestre de manera consistente en diferentes implementaciones.
  • Extensibilidad: CommonMark permite la adición de extensiones para cubrir funcionalidades adicionales sin romper la especificación básica.

Ejemplo de CommonMark,

# Encabezado de Nivel 1

Este es un párrafo con **negrita** y *cursiva*.

- Lista desordenada
  - Elemento secundario

1. Lista ordenada
2. Segundo ítem

[Enlace a Google](https://www.google.com)

GitHub Flavored Markdown (GFM)

GitHub Flavored Markdown es una variante de Markdown que se utiliza en GitHub para formatear archivos README, comentarios y otros contenidos. Por este motivo es muy popular y adoptada.

Características principales de GFM,

  • Tareas y Checklists: Permite la creación de listas de tareas interactivas que se pueden marcar como completadas.
  • Tablas: Soporta tablas con una sintaxis específica para crear tablas de manera sencilla.
  • Notas al Pie: Aunque no está soportado nativamente en GFM, se pueden usar extensiones de terceros para añadir notas al pie.

Ejemplo de sintaxis en GFM,

# Encabezado de Nivel 1

- [x] Tarea completada
- [ ] Tarea pendiente

| Columna 1 | Columna 2 |
|-----------|-----------|
| Valor 1   | Valor 2   |
| Valor 3   | Valor 4   |

```python
def saludo():
    print("Hola, Mundo!")
```

[Enlace a GitHub](https://github.com)

Markdown Extra

Markdown Extra es una extensión de Markdown que añade nuevas características a la sintaxis original. Fue desarrollado por Michel Fortin para proporcionar una mayor funcionalidad en la creación de contenido.

Características principales de Markdown Extra,

  • Tablas: Permite la creación de tablas con una sintaxis específica.
  • Definición de Listas: Soporta listas de definición.
  • Citas de Bloque con Adicionales: Permite la inclusión de elementos adicionales en las citas de bloque.

Ejemplo de sintaxis en Markdown Extra,

# Encabezado de Nivel 1

## Tabla

Nombre | Edad
-------|-----
Luis   | 25
Ana    | 30

## Lista de Definición

Término
: Definición del término

MultiMarkdown

MultiMarkdown es una extensión de Markdown que añade características avanzadas para la creación de documentos más complejos, como documentos académicos y libros. Fue desarrollado por Fletcher Penney.

Características principales de MultiMarkdown,

  • Soporte para Metadatos: Permite la inclusión de metadatos en el encabezado del documento.
  • Notas al Pie y Referencias: Mejora el manejo de notas al pie y referencias bibliográficas.
  • Fórmulas y Ecuaciones: Permite la inclusión de fórmulas matemáticas.

Ejemplo de Sintaxis en MultiMarkdown,

% Título del Documento
% Autor
% Fecha

# Encabezado de Nivel 1

Este es un párrafo con una fórmula matemática: \( E = mc^2 \).

## Notas al Pie

Aquí va una nota al pie[^1].

[^1]: Esta es una nota al pie en MultiMarkdown.

R Markdown

R Markdown es una variante de Markdown que se utiliza en el ecosistema de R para combinar texto con código en el contexto de análisis de datos y generación de informes.

Características principales de R Markdown,

  • Integración con R: Permite incluir código R directamente en el documento y generar resultados dinámicamente.
  • Formateo de Documentos: Soporta la generación de documentos en formatos como HTML, PDF y Word.
  • Celdas de Código: Permite la inclusión de celdas de código para ejecutar scripts y mostrar resultados en el documento.

Ejemplo de sintaxis en R Markdown

---
title: "Título del Documento"
author: "Autor"
output: html_document
---

# Análisis de Datos

```{r}
summary(cars)
```

El análisis de los datos de los coches se presenta arriba.