Trabajo con Markdown en Kotlin: bibliotecas y analizadores

Trabajo con Markdown en Kotlin: descripción general de bibliotecas y herramientas

\n\n

Markdown es un popular lenguaje de marcado para formatear texto, ampliamente utilizado en documentación, archivos README, blogs y sistemas de gestión de contenido. En el ecosistema de Kotlin existen varias bibliotecas maduras que permiten analizar Markdown, convertirlo a HTML y crear extensiones personalizadas. En este artículo, analizaremos tres enfoques principales: el uso de commonmark-java, flexmark-java y la biblioteca nativa kmarkdown.

\n\n

1. Biblioteca commonmark-java

\n\n

commonmark-java es la implementación oficial en Java de la especificación CommonMark, que funciona perfectamente en Kotlin. Ofrece una API sencilla, alto rendimiento y estricto cumplimiento del estándar.

\n\n

Instalación

\n

Añada la dependencia en build.gradle.kts:

\n

implementation("org.commonmark:commonmark:0.21.0")

\n\n

Ejemplo de uso

\n

import org.commonmark.parser.Parser\nimport org.commonmark.renderer.html.HtmlRenderer\n\nfun main() {\n    val parser = Parser.builder().build()\n    val document = parser.parse("**Hola**, esto es *Markdown* en Kotlin!")\n    val renderer = HtmlRenderer.builder().build()\n    val html = renderer.render(document)\n    println(html)\n    // Salida: <p><strong>Hola</strong>, esto es <em>Markdown</em> en Kotlin!</p>\n}

\n\n

La biblioteca soporta todos los elementos básicos: encabezados, listas, enlaces, imágenes, código y bloques de código. Para ampliar la funcionalidad, se pueden añadir módulos adicionales, como commonmark-ext-gfm-tables para tablas de GitHub Flavored Markdown.

\n\n

2. Biblioteca flexmark-java

\n\n

flexmark-java es una alternativa más potente y flexible. Soporta CommonMark, GitHub Flavored Markdown (GFM), así como múltiples extensiones: notas al pie, anclajes, emojis, fórmulas matemáticas y sintaxis personalizadas.

\n\n

Instalación

\n

implementation("com.vladsch.flexmark:flexmark-all:0.64.8")

\n\n

Ejemplo con extensiones

\n

import com.vladsch.flexmark.html.HtmlRenderer\nimport com.vladsch.flexmark.parser.Parser\nimport com.vladsch.flexmark.ext.tables.TablesExtension\nimport com.vladsch.flexmark.ext.gfm.strikethrough.StrikethroughExtension\n\nfun main() {\n    val extensions = listOf(TablesExtension.create(), StrikethroughExtension.create())\n    val parser = Parser.builder().extensions(extensions).build()\n    val document = parser.parse("| Título | Descripción |\\n|--------|-------------|\\n| Kotlin | Lenguaje    |\\n\\n~~Texto tachado~~")\n    val renderer = HtmlRenderer.builder().extensions(extensions).build()\n    println(renderer.render(document))\n}

\n\n

Flexmark también permite personalizar el renderizado: añadir clases CSS, cambiar el orden de los atributos, crear visitantes personalizados para el árbol AST. Esto lo convierte en la opción ideal para proyectos complejos que requieren un ajuste fino de la salida.

\n\n

3. Biblioteca nativa kmarkdown

\n\n

kmarkdown es una implementación puramente en Kotlin del analizador Markdown, escrita utilizando corrutinas y características integradas del lenguaje. Es ligera y no requiere dependencias adicionales más allá de la biblioteca estándar de Kotlin.

\n\n

Instalación

\n

implementation("net.nightwhistler:kmarkdown:1.0.2")

\n\n

Ejemplo

\n

import net.nightwhistler.kmarkdown.KMarkdown\n\nfun main() {\n    val markdown = KMarkdown()\n    val html = markdown.parseToHtml("# Título\\n\\n**Texto** normal")\n    println(html)\n    // Salida: <h1>Título</h1><p><strong>Texto</strong> normal</p>\n}

\n\n

Kmarkdown es adecuado para escenarios simples donde no se requiere soporte para funciones avanzadas de GFM. Su ventaja es la limpieza del código y la ausencia