Docusaurus vs Livemark
Actualizado el 12 nov 2026
Docusaurus es un framework de documentación de código abierto mantenido por Meta. Renderiza contenido React + MDX mediante un pipeline de compilación basado en Webpack, incluye versionado e internacionalización de primera clase y cuenta con un amplio ecosistema de plugins.
De un vistazo
| Eje | Livemark | Docusaurus |
|---|---|---|
| Lenguaje / runtime | TypeScript / Node 24+ | TypeScript / Node 18+ |
| Framework de UI | React 19 | React 18 |
| Herramienta de compilación | Vite + TanStack Start | Webpack |
| Formato de contenido | Markdown + MDX | Markdown + MDX |
| Licencia | MIT, autoalojado | MIT, autoalojado |
| Modelo de salida | Estático prerenderizado (compatible con SSR) | Estático prerenderizado |
Arquitectura
Livemark envuelve Vite, TanStack Start y React en una única CLI sin configuración. El contenido se carga a partir de archivos .md seleccionados por glob, se compila como Markdown, o como MDX en los archivos .mdx, en tiempo de compilación y se prerenderiza a HTML estático para cada ruta.
Docusaurus está construido sobre Webpack. El runtime es React Router + un núcleo de Docusaurus que gestiona los temas, los plugins y las fuentes de contenido. Los plugins son de primera clase: cada funcionalidad integrada (docs, blog, páginas, búsqueda) es en sí misma un plugin, y los terceros extienden el sistema de la misma forma.
La organización del contenido no tiene restricciones en el lado de Livemark: escanea por glob (include/exclude en livemark.config.ts), y la URL de cada artículo sigue la ubicación del archivo bajo su glob de include, salvo que la defina un campo path: del frontmatter. No hay una carpeta docs/ obligatoria: un proyecto puede tomar artículos de README.md, docs/, blog/, los README de los paquetes o de cualquier otro lugar. El plugin de docs de Docusaurus espera un directorio docs/ (configurable mediante path, pero basado en carpetas en lugar de en globs).
Superficie de contenido
Ambas herramientas aceptan Markdown y MDX con frontmatter. Ambas permiten incrustar componentes de React dentro de archivos .mdx.
Las directivas de Livemark (:::card, :::tip, :::tab, …) las compila textlane, el pipeline de Markdown en Rust que ejecuta Livemark. Docusaurus usa componentes MDX más una extensión admonition para los avisos.
La forma del frontmatter difiere: Livemark usa path, order, icon, sidebar, date, tags. Docusaurus usa id, slug, sidebar_position, sidebar_label, tags.
Matriz de funcionalidades
| Capacidad | Livemark | Docusaurus |
|---|---|---|
| Versionado | Parcial (secciones o despliegues por rama) | Sí (integrado) |
| Internacionalización (i18n) | Sí (integrada) | Sí (integrada) |
| Búsqueda | Sí (Orama, en el cliente) | Integración con Algolia DocSearch |
| Blog | Sí (tipo de sección integrado) | Sí (plugin integrado) |
| Registro de cambios | Sí (tipo de sección, divide por encabezado de versión) | No (plugins de la comunidad) |
| Sitemap | Sí | Sí |
| RSS | Sí (por sección de blog) | Sí (para el plugin de blog) |
| Temas | Sobrescritura de componentes mediante .livemark/ | Paquetes de tema (@docusaurus/theme-*) |
| Plugins | Plugins de Vite + textlane | API de plugins de primera clase |
| Rutas personalizadas | .livemark/routes/ (TanStack Router) | Rutas definidas por plugins |
Salida y despliegue
Livemark prerenderiza cada ruta en disco en .livemark/build/client/: consulta Despliegue para ver guías específicas por proveedor.
Docusaurus también prerenderiza a HTML estático, con salida en build/. La salida estática funciona en los mismos proveedores (GitHub Pages, Cloudflare, Vercel, Netlify, hosting estático). La i18n integrada de Docusaurus produce árboles de salida separados por idioma.
Ver también
- Autoría: la superficie de Markdown de Livemark.
- Personalización: las opciones de configuración de Livemark y la sobrescritura de componentes.
- Comparativa: volver al índice.
Hecho con ❤ y Livemark