VitePress vs Livemark
Actualizado el 12 nov 2026
VitePress es el framework oficial de documentación de Vue, construido sobre Vite. Está centrado en Markdown, incluye un tema por defecto minimalista y es lo que impulsa la mayor parte de la documentación del ecosistema Vue (el propio Vue, Vite, Pinia, …).
De un vistazo
| Eje | Livemark | VitePress |
|---|---|---|
| Lenguaje / entorno de ejecución | TypeScript / Node 24+ | TypeScript / Node 18+ |
| Framework de UI | React 19 | Vue 3 |
| Herramienta de compilación | Vite + TanStack Start | Vite (pipeline de compilación propio) |
| Formato de contenido | Markdown + MDX | Markdown con plantillas de Vue |
| Licencia | MIT, autoalojado | MIT, autoalojado |
| Modelo de salida | Estático prerenderizado (compatible con SSR) | Estático prerenderizado (SSG) |
Arquitectura
Ambas herramientas son nativas de Vite. La diferencia está en todo lo que hay por encima de Vite: Livemark añade TanStack Start (router + funciones de servidor + pipeline de prerenderizado) y renderiza React; VitePress envuelve Vite con su propio pipeline SSG y renderiza Vue.
El entorno de ejecución de VitePress es vue-router más un tema por defecto integrado. Livemark usa TanStack Router e incluye su propia capa de componentes (barra lateral, diseño, búsqueda) que los proyectos pueden sobrescribir archivo a archivo mediante .livemark/.
En Livemark la organización del contenido no tiene restricciones: escanea mediante 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 fije un campo path: del frontmatter. No hace falta una carpeta docs/: un proyecto puede tomar artículos de README.md, docs/, blog/, los README de paquetes o cualquier otro lugar. VitePress espera todo el contenido bajo una única raíz de código fuente (docs/ por defecto, configurable mediante srcDir), con rutas derivadas de las rutas de archivo.
Superficie de contenido
VitePress acepta Markdown con plantillas de Vue integradas: puedes usar componentes Vue y bloques <script setup> dentro de archivos .md. No admite MDX en el sentido de React.
Livemark acepta Markdown + MDX. Los componentes insertados son React.
Ambos admiten frontmatter para los metadatos de cada página. VitePress usa title, layout, sidebar, outline, prev/next. Livemark usa path, order, icon, sidebar, date, tags.
Avisos/admoniciones: VitePress usa contenedores ::: tip / ::: warning (la misma sintaxis que las directivas :::tip de Livemark, evaluada por parsers distintos).
Matriz de funcionalidades
| Capacidad | Livemark | VitePress |
|---|---|---|
| Versionado | Parcial (secciones o despliegues por rama) | No (soluciones de la comunidad) |
| Internacionalización (i18n) | Sí (integrado) | Sí (integrado) |
| Búsqueda | Sí (Orama, en el cliente) | Sí (local + Algolia) |
| Blog | Sí (tipo de sección integrado) | No (plugins de la comunidad) |
| Registro de cambios | Sí (tipo de sección) | No |
| Sitemap | Sí | Sí |
| RSS | Sí (por sección de blog) | No |
| Temas | Sobrescritura de componentes vía .livemark/ | Temas personalizados vía .vitepress/theme/ |
| Plugins | Plugins de Vite + textlane | Plugins de Vite + plugins de markdown-it |
| Rutas personalizadas | .livemark/routes/ (TanStack Router) | Rutas dinámicas mediante paths() |
Salida y despliegue
Ambos producen un directorio de HTML estático + recursos listo para cualquier hosting estático. VitePress emite en .vitepress/dist/ por defecto; Livemark emite en .livemark/build/client/. El alojamiento es idéntico; consulta Despliegue de Livemark para las guías por hosting.
Ver también
- Redacción: la superficie 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