# Mintlify vs Htmlpress

> Generador de sitios de código abierto y autoalojado frente a un SaaS comercial de docs alojado.

[Mintlify](https://mintlify.com) es una plataforma comercial de documentación. El contenido se redacta en MDX dentro de un repositorio Git; Mintlify aloja el sitio renderizado, la búsqueda y la analítica. El precio es por editor, con un plan gratuito para proyectos de código abierto.

## De un vistazo

| Aspecto                    | Htmlpress                                                | Mintlify                                                                  |
| -------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------- |
| Lenguaje / runtime         | Rust (binario único, sin runtime)                        | Redacción en MDX; el runtime es el stack alojado de Mintlify (no público) |
| Framework de UI            | Ninguno (HTML + CSS plano, web components `htmlpress-*`) | React (según la documentación de Mintlify)                                |
| Herramienta de compilación | Binario de htmlpress                                     | CLI de Mintlify (vista previa) + compilación alojada                      |
| Formato de contenido       | Páginas HTML y Markdown                                  | Markdown + MDX                                                            |
| Licencia                   | MIT, autoalojado                                         | Propietaria, solo alojado                                                 |
| Modelo de salida           | Estático prerenderizado                                  | Alojado en la infraestructura de Mintlify                                 |

## Arquitectura

htmlpress es un único binario de Rust que se instala desde npm (`gethtmlpress`), PyPI o crates.io. Envuelve cada página HTML en un layout con una navegación y un tema; no hay bundler, ni framework de UI, ni API de plugins. Cada archivo integrado (el layout, los estilos, los scripts y cada componente) se puede escapar: un archivo en la misma ruta bajo `.htmlpress/` lo reemplaza. Tanto el código fuente como la salida son tuyos.

Mintlify es un SaaS alojado. Haces commit de MDX + un archivo de configuración `mint.json` a un repositorio Git; Mintlify lo descarga en cada push, lo compila y sirve el resultado desde `<your-subdomain>.mintlify.app` o un dominio propio. El pipeline de compilación y el runtime están gestionados y no se pueden instalar por tu cuenta.

En htmlpress la disposición del contenido no tiene restricciones: escanea por glob (`include`/`exclude` en `htmlpress.yaml`, todos los archivos `.html` por defecto), y la URL de una página sigue su ruta de archivo bajo la base del glob, así que `docs/**/*.html` sirve `docs/guide.html` en `/guide/`. No hace falta una carpeta `docs/`. La navegación se construye a partir de las carpetas y del `<meta name="order">` de cada página; el `index.html` de una carpeta da nombre a su grupo. Mintlify espera que el árbol de archivos coincida con el bloque `navigation` de `mint.json`; las rutas reflejan las rutas de archivo bajo la raíz de contenido configurada.

## Superficie de contenido

Mintlify acepta Markdown + MDX con frontmatter e incrustación de componentes. Trae un conjunto fijo de componentes (`<Card>`, `<Accordion>`, `<Tabs>`, `<Steps>`, …) que los autores combinan en MDX. No escribes tus propios componentes de React para la UI de la documentación: usas las primitivas de Mintlify.

Las páginas de htmlpress son HTML semántico plano, al que el tema da estilo a partir de los propios elementos. Los bloques más ricos son elementos personalizados `htmlpress-*` (`htmlpress-callout`, `htmlpress-tabs`, `htmlpress-filetree`, `htmlpress-cards`, …), cuyo CSS y JS se enlazan solo en las páginas que usan la etiqueta. Un proyecto añade su propia etiqueta con `.htmlpress/components/<name>/<name>.html`, que reemplaza la etiqueta en tiempo de compilación. Los integrados (`htmlpress-cards` + `htmlpress-card`, `htmlpress-tabs`, `htmlpress-filetree`) producen el mismo tipo de UI y cada uno se puede escapar.

El `mint.json` de Mintlify configura la navegación, la marca y las integraciones en un único archivo declarativo. htmlpress usa `htmlpress.yaml` para los ajustes del sitio y el `<head>` de cada página para los suyos propios.

## Matriz de funciones

| Capacidad                   | Htmlpress                                                               | Mintlify                            |
| --------------------------- | ----------------------------------------------------------------------- | ----------------------------------- |
| Versionado                  | Parcial (una sección o un despliegue por versión)                       | Sí (integrado)                      |
| Internacionalización (i18n) | Sí (traducciones, selector de idioma, 7 idiomas de interfaz incluidos)  | Sí (integrada)                      |
| Búsqueda                    | Sí (integrada, en el cliente)                                           | Sí (integrada, con IA)              |
| Chat con IA / agentes       | No (archivos para agentes: `llms.txt`, copias en Markdown, skills)      | Sí (integrado)                      |
| Analítica                   | No (trae la tuya mediante scripts en `head`)                            | Sí (panel integrado)                |
| Renderizado de OpenAPI      | No                                                                      | Sí (integrado)                      |
| Blog                        | No                                                                      | Sí (páginas de changelog/novedades) |
| Sitemap                     | Sí (con `site` definido)                                                | Sí                                  |
| RSS                         | No                                                                      | Sí (feeds del changelog)            |
| Temas                       | Escapes en `.htmlpress/` + tokens `--htmlpress-*`                       | Temas mediante `mint.json`          |
| Rutas personalizadas        | Cualquier archivo `.html`; layouts adicionales en `.htmlpress/layouts/` | No (solo contenido)                 |
| Autoalojamiento             | Sí                                                                      | No                                  |

## Salida y despliegue

htmlpress escribe cada página como HTML estático en `.htmlpress/build/`, junto con `robots.txt`, un `sitemap.xml` cuando `site` está definido, una copia en Markdown de cada página, `llms.txt` y las skills para agentes en `.well-known/agent-skills/`. La clave `base` sirve el sitio bajo una subruta. Consulta [Despliegue](/es/deployment/) para ver guías por hosting.

De los despliegues de Mintlify se encarga Mintlify. No compilas ni alojas la salida tú mismo; la plataforma sirve el sitio renderizado desde su CDN y gestiona TLS, dominios y vistas previas. Desvincularte de Mintlify implica reescribir el contenido o migrarlo a otro lugar.

## Ver también

- [Redacción](/es/authoring/) — la superficie HTML de htmlpress.
- [Personalización](/es/customization/) — las claves de configuración y los escapes de htmlpress.
- [Comparativa](/es/comparison/) — volver al índice.