lite-mdx
lite-mdx
lite-mdx es un compilador ultrarrápido y sin dependencias para componentes MDX y JSX. Transforma etiquetas JSX, elementos compuestos y expresiones dinámicas de JavaScript en HTML y Markdown limpios sin necesidad de Babel, Unified ni pesadas cadenas de herramientas AST.
Paquete menor a 8KB
lite-mdx ocupa menos de 8KB minificado y se ejecuta de manera idéntica en Node.js, navegadores modernos, funciones Edge y Cloudflare Workers.
Instalación
pnpm
npm
bun
pnpm add lite-mdx
npm install lite-mdx
bun add lite-mdx
Inicio Rápido
import { compile } from 'lite-mdx';
const mdx = `
# Bienvenido a {project.name}
<Callout type="tip">
Este es un consejo para **v{project.version}**.
</Callout>
<Button variant="primary">Empezar</Button>
`;
const result = compile(mdx, {
scope: {
project: { name: 'docmd', version: '0.10.0' }
},
components: {
Callout: (props, children) => `<div class="callout ${props.type}">${children}</div>`,
Button: (props, children) => `<button class="${props.variant}">${children}</button>`
}
});
console.log(result.content);
Características
- Cero dependencias: Implementación pura en TypeScript/ESM.
- Jerarquía de componentes: Etiquetas con autocierre (
<Badge />), componentes de bloque (<Callout>...</Callout>) y componentes con punto (<Tabs.Tab>). - Atributos enriquecidos: Compatibilidad con cadenas, números, booleanos, objetos y propagación
{...props}. - Interpolación dinámica: Evalúa expresiones como
{frontmatter.title}dentro de un entorno seguro. - Aislamiento de código: Los bloques de código y las comillas invertidas están protegidos contra la ejecución.