Docusaurus
Generador de sitios estáticos de código abierto para documentación, publicado por Meta
Docusaurus es un generador de sitios estáticos de código abierto de Meta, con licencia MIT, para crear y mantener sitios de documentación. Un solo comando levanta un sitio basado en React que ya trae una sección de documentación con versiones, un blog, páginas sueltas y un tema, y el repositorio incluye complementos mantenidos para sitemaps, búsqueda con Algolia, traducciones, redirecciones y etiquetas de analítica. Tiene 65.749 estrellas a julio de 2026. Para un fundador que lanza una herramienta para desarrolladores elimina el coste de construir un sitio de documentación, que es una cosa distinta de que alguien llegue a leerlo.
Qué es Docusaurus
Docusaurus (github.com/facebook/docusaurus) se describe como un proyecto para crear, desplegar y mantener con facilidad sitios web de proyectos de código abierto. En la práctica es un generador de sitios estáticos basado en React donde la documentación es el ciudadano de primera clase: un comando, npm init docusaurus@latest, produce un sitio que ya tiene sección de documentación, blog, páginas sueltas y un tema, así que el primer día se dedica a escribir contenido y no a montar un stack. Meta lo publicó porque les ayuda a escalar entre los muchos proyectos de código abierto que mantienen. El código tiene licencia MIT y el contenido de la documentación del repositorio lleva una licencia Creative Commons aparte.
- Los tipos de contenido son complementos separados — el repositorio publica paquetes propios distintos para documentación, para blog y para páginas sueltas, de modo que un sitio puede ser solo documentación, documentación más un changelog, o un sitio completo con página de inicio comercial, sin traer una segunda herramienta.
- Las piezas que normalmente añadirías aparte ya están — generación de sitemap, búsqueda con Algolia, redirecciones en cliente para las URL que muevas, traducciones, soporte PWA, diagramas Mermaid, optimización de imágenes y etiquetas de Google Analytics existen como paquetes mantenidos dentro del mismo repositorio.
- El formato de escritura es MDX — las páginas son Markdown que puede incrustar componentes de React, que es lo que hace posible un bloque de código ejecutable o un ejemplo interactivo dentro de una página que por lo demás es solo un archivo de tu repositorio.
Documentación, blog y página comercial son tres trabajos distintos
La forma más común de desperdiciar un sitio de documentación es tratarlo como una superficie de contenido más y juzgarlo todo con el mismo número. Estas tres superficies atraen a personas distintas que llegan en estados distintos, y solo una de ellas intenta que la encuentre alguien que nunca ha oído hablar de ti.
| Superficie | Quién llega | Qué puede y qué no puede hacer |
|---|---|---|
| Documentación | Alguien que ya usa el producto, o que comprueba si puede hacer una cosa concreta | Elimina dudas y desbloquea la puesta en marcha. Rara vez crea demanda por sí sola, pero es donde un quizá se convierte en un sí |
| Blog o changelog | Alguien que busca un problema, o un usuario actual que mira qué se ha lanzado | Puede ganar visitantes nuevos y dar a los actuales un motivo para volver. Necesita una razón de existir más allá de las notas de versión |
| Página de inicio comercial | Alguien que decide si el asunto le importa siquiera | Encuadra el producto para desconocidos. La documentación no puede hacer este trabajo, y la que lo intenta se lee como un manual |
Docusaurus alojará las tres encantado, y ahí está la trampa: como salen en una misma compilación, se revisan como una sola cosa. Separa los informes antes que ninguna otra cosa: una página de documentación y una de aterrizaje se ven idénticas en una tabla de tráfico mientras responden preguntas completamente distintas. Si la mitad editorial es el trabajo de verdad, Ghost está hecho para eso; si el contenido necesita una interfaz de edición para quien no abre pull requests, eso es Payload.
Dónde encaja un sitio de documentación en el stack de crecimiento
La documentación es el contenido con más intención que posee la mayoría de las herramientas para desarrolladores, y en el que menos se invierte de forma sistemática. También posiciona, en un tipo concreto de consulta: los desarrolladores buscan mensajes de error, nombres de API y de funciones, y formulaciones del tipo cómo hago esto concreto en esta herramienta concreta. Son consultas con poca competencia y mucha intención, y una respuesta precisa las gana sin el trabajo que exige un término principal competido. Es una superficie de captación real, pero estrecha, porque casi todas esas consultas ya contienen el nombre de tu producto o un problema que tu producto creó. La documentación multiplica lo que ya tienes en lugar de iniciarlo. Ganar la atención primero se trabaja en cómo hago marketing de una herramienta para desarrolladores, y poseer un tema en vez de una página es autoridad temática.
Nota de primera mano al construir AgentCeres —el AI Growth Officer, en agentceres.com—: lo que no esperábamos es que una página de documentación y una comercial se ven idénticas en un informe de analítica mientras hacen trabajos opuestos. Una la lee alguien que está decidiendo; la otra, alguien que ya decidió y ahora está atascado. Solo lo notamos porque las preguntas que llegaban al chat de nuestro propio producto eran, casi línea por línea, los títulos que nuestra documentación debería haber tenido. Un hilo de soporte resulta ser mejor índice que cualquier herramienta de palabras clave, porque es una lista de los puntos exactos donde el producto dejó de ser evidente, ordenada por cuántas veces la gente choca con ellos. Si instalas Docusaurus esta semana, la página más valiosa que escribir primero no es el recorrido de funciones. Es la respuesta a la pregunta que ya has tecleado a mano tres veces.
FAQ
- ¿Docusaurus es gratis?
- El repositorio indica que Docusaurus tiene licencia MIT, con el contenido de documentación del repo bajo una licencia Creative Commons aparte. No hay plan de pago, porque genera archivos estáticos que alojas donde quieras, así que el coste es el del alojamiento que elijas, a menudo ninguno para un sitio estático. Revisa los archivos LICENSE de la versión que instales, porque las licencias cambian al margen de cualquier artículo.
- ¿Docusaurus o un framework web generalista?
- Si el sitio es sobre todo documentación, gana la herramienta especializada, porque las versiones de documentos, las barras laterales, la búsqueda y una arquitectura de información con forma de documentación ya están resueltas y las estarías rehaciendo. Si la documentación es una sección de un sitio comercial con exigencias fuertes de diseño, suele ganar un framework general más una capa de contenido, porque si no pasarás el tiempo peleando con un tema construido alrededor de otro centro de gravedad. La pregunta es para cuál de las dos cosas es el sitio principalmente.
- ¿Los sitios de documentación ayudan de verdad al SEO?
- Pueden, en una clase concreta de consulta: mensajes de error, nombres de API y de funciones, preguntas de integración y formulaciones de cómo hago tal cosa que nombran tu herramienta. Son consultas poco competidas y de mucha intención, y una respuesta precisa las gana sin necesitar mucha autoridad de dominio. Lo que la documentación no puede hacer es posicionar para los términos amplios de categoría que llegan a quien nunca ha oído hablar de ti. Ese tráfico hay que ganarlo en otro sitio.
- ¿Debería activar el blog integrado?
- Solo si de verdad lo vas a usar. Un changelog es un buen valor por defecto: tiene material de forma natural y da a los usuarios que vuelven un motivo para hacerlo. Un blog comercial es un compromiso mayor de lo que parece, y uno abandonado que muestra tres entradas de hace año y medio se lee peor que no tener blog. Empieza por el changelog y añade el blog cuando tengas un conjunto concreto de preguntas que pienses responder.
You built it. Now grow it.
AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.