nginx-markdown-for-agents
Módulo NGINX en Rust que convierte HTML a Markdown para agentes de IA mediante negociación de contenido. Soporta bots específicos por User-Agent, sin reescribir aplicaciones. Compatible con múltiples plataformas y versiones de NGINX.
Ficha actualizada 28 sept 2026, 7:16 · upstream 28 sept 2026, 7:08 · release v0.9.1
Qué es nginx-markdown-for-agents
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este módulo de NGINX añade una representación de Markdown amigable para máquinas a páginas HTML existentes. Cuando los clientes envían el encabezado Accept: text/markdown, reciben Markdown en lugar de HTML. Los navegadores y otros clientes continúan recibiendo la respuesta original HTML sin cambios. La conversión ocurre en el borde de NGINX, sin necesidad de reescribir aplicaciones ni servicios adicionales.
La versión 0.9.2 es candidata a lanzamiento con 20 directivas activas congeladas. Soporta compresión upstream (gzip, deflate, Brotli), caché con ETags y solicitudes condicionales. Permite configurar límites de memoria, tiempo de conversión y buffers de streaming. La interfaz FFI interna avanza a v3 entre C/Rust.
El módulo incluye capacidades de observabilidad con Prometheus metrics, políticas de error configurables y modo shadow para pruebas. Soporta múltiples plataformas (Ubuntu, Debian, Alpine, macOS) mediante paquetes binarios, módulos dinámicos o builds desde fuente. La instalación es sencilla vía Homebrew en macOS o paquetes oficiales en Linux.
- Servir documentación técnica a LLMs reduciendo tokens y ruido del navegador
- Convertir páginas web para agentes de IA sin reescribir backend
- Dirigir conversión Markdown solo a bots específicos por User-Agent
- Reducir uso de tokens en RAG pipelines al servir contenido limpio
- Observabilidad con métricas Prometheus para monitorear conversiones
- Conversión en el borde sin reescritura de aplicación backend
- Soporte nativo para múltiples formatos de compresión upstream
- Configuración explícita de límites de memoria y tiempo de conversión
- Compatibilidad con NGINX 1.26.3 a 1.31.5 en múltiples plataformas
- Observabilidad completa con métricas Prometheus y JSON schema v3
- Versión 0.9.2 es candidata de lanzamiento, no estable oficial aún
- Directivas legacy eliminadas requieren migración antes de actualizar
- FFI interno sin garantía de compatibilidad entre versiones
- Requiere rebuild conjunto del módulo y conversor Rust tras cambios en FFI v3
- Sin soporte Dockerfile o compose nativo en el repositorio
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar vía paquetes oficiales, Homebrew (macOS) o builds desde fuente. Configurar markdown_filter on con proxy_pass al backend. Usar markdown_accept strict por defecto para rollout gradual. Verificar con curl -H "Accept: text/markdown". Consultar MIGRATION-0.9.2.md antes de actualizar configuraciones existentes. Rebuild conjunto del módulo y conversor Rust tras cambios en FFI v3.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.