MkDocs vs Livemark

Actualizado el 12 nov 2026

MkDocs es un generador de documentación basado en Python. El contenido es Markdown plano, las plantillas son de Jinja2 y los temas son paquetes de Python instalables con pip. El tema de facto es Material for MkDocs, que es lo que usa en realidad la mayoría.

De un vistazo

Arquitectura

Livemark se apoya en Vite, TanStack Start y React. La redacción sigue las convenciones de JS/TS (livemark.config.ts, plugins instalables con npm, componentes MDX escritos en React).

MkDocs es una CLI de Python. El sitio se configura con mkdocs.yml. Los temas se instalan con pip; el pipeline de compilación pasa el contenido Markdown por Python-Markdown (o pymdown-extensions) y por plantillas Jinja2. No hay paso de compilación de JavaScript: la interactividad del sitio renderizado es la que emitan las plantillas del tema.

Material for MkDocs añade un tema cuidado, un índice de búsqueda basado en lunr.js, navegación instantánea y un amplio ecosistema de plugins (los extras de mkdocs-material, más el espacio de nombres más amplio de plugins mkdocs-* en PyPI).

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. MkDocs lee de docs/ (configurable mediante docs_dir en mkdocs.yml), con rutas derivadas de las rutas de archivo dentro de ese directorio.

Superficie de contenido

Ambas herramientas aceptan Markdown con frontmatter. La gran asimetría está en la inserción de componentes: Livemark acepta MDX (componentes React en archivos .mdx); MkDocs solo acepta Markdown.

MkDocs amplía Markdown mediante extensiones de Python-Markdown (admoniciones, pestañas, notas al pie, listas de definiciones) y pymdown-extensions (que añade toda la sintaxis de Material: pestañas === "Tab 1", admoniciones :::note, atajos de teclado ++ctrl++, etc.). Personalizar más allá de lo que ofrecen las extensiones requiere escribir un plugin de Python o sobrescribir una plantilla Jinja.

La forma del frontmatter difiere: MkDocs lee title, summary, tags (con un plugin), template, y usa mkdocs.yml para la navegación. Livemark usa path, order, icon, sidebar, date, tags.

Matriz de funcionalidades

Salida y despliegue

Ambas herramientas producen HTML estático + recursos listos para cualquier hosting estático. MkDocs emite en site/ por defecto; Livemark emite en .livemark/build/client/. El alojamiento es igual en ambos casos; 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.