Trabajo con Markdown en Rust: bibliotecas, analizadores y…

Trabajo con Markdown en Rust: reseña de herramientas y bibliotecas

Rust, conocido por su rendimiento y seguridad, ofrece varias bibliotecas maduras para trabajar con Markdown. Ya sea que estés creando un generador de sitios estáticos, un chatbot, un sistema de documentación o un editor de notas, la elección correcta de la herramienta te ahorrará horas de desarrollo. En este artículo analizaremos tres bibliotecas principales: pulldown-cmark, markdown y comrak, y mostraremos ejemplos prácticos de su uso.

1. pulldown-cmark — analizador orientado a eventos

pulldown-cmark es la biblioteca más popular y rápida para analizar Markdown en Rust. Implementa la especificación CommonMark y funciona según el principio de "pull": obtienes un flujo de eventos (etiquetas, texto, enlaces) que se puede procesar directamente o convertir a HTML.

Características principales:

Soporte completo de CommonMark 0.30
Consumo mínimo de memoria
Soporte para tablas, texto tachado, enlaces automáticos
Posibilidad de personalización mediante el procesamiento de eventos
Funcionamiento sin asignaciones (análisis sintáctico zero-copy)

Ejemplo de análisis sintáctico y renderizado a HTML:

use pulldown_cmark::{Parser, html};

fn main() {    let markdown_input = "# ¡Hola, mundo!

Este es texto en **negrita** y *cursiva*.";    let parser = Parser::new(markdown_input);    let mut html_output = String::new();    html::push_html(&mut html_output, parser);    println!("{}", html_output);}

El resultado de la ejecución es HTML correcto con las etiquetas <h1>, <strong> y <em>. La biblioteca es ideal para sistemas de alta carga donde la velocidad es importante.

2. markdown (crate) — convertidor universal

La biblioteca markdown (crate markdown) proporciona tanto análisis sintáctico como conversión a varios formatos. A diferencia de pulldown-cmark, ofrece una API de más alto nivel y opciones de salida adicionales.

Características clave:

Soporte para CommonMark y GitHub Flavored Markdown (GFM)
Renderizado a HTML, LaTeX, terminal
Arquitectura extensible con plugins
Soporte integrado para saneamiento de HTML
Trabajo con metadatos YAML front matter

Ejemplo con configuración:

use markdown::to_html_with_options;use markdown::Options;

fn main() {    let md = "## Código en Rust```rustfn main() {    println!(\\"Hello\\");}```";    let opts = Options {        compile: markdown::CompileOptions {            allow_dangerous_html: false,            allow_dangerous_protocol: false,            ..markdown::CompileOptions::default()        },        ..markdown::Options::default()    };    let html = to_html_with_options(md, &opts).unwrap();    println!("{}", html);}

Este ejemplo demuestra el renderizado seguro de código con resaltado de sintaxis (si se conecta un crate adicional). markdown se recomienda para proyectos que necesitan flexibilidad y soporte para formatos de salida no estándar.

3. comrak — analizador extendido para GFM

comrak es un fork del popular analizador cmark con extensiones adicionales de GitHub. Es la mejor opción si tu proyecto requiere una correspondencia exacta con el Markdown de GitHub, incluyendo escape, listas de tareas y emojis.

Características de comrak: