Pasa tus docs de GitBook a OpenDocs
Sincroniza tu espacio de GitBook con GitHub y luego impórtalo en OpenDocs. Las páginas conservan su orden y su jerarquía, y no tienes que volver a escribir nada.
Cinco pasos, en este orden
- Sincroniza tu espacio de GitBook con GitHub. En GitBook, activa Git Sync y sincroniza el espacio con un repositorio de GitHub. GitBook escribe tus páginas como archivos Markdown, con un archivo
SUMMARY.mdque contiene la tabla de contenido. Git Sync es una función de GitBook, así que confirma que tu plan de GitBook la incluye. - Crea un espacio en OpenDocs. Empieza gratis: toda cuenta comienza con 14 días de Pro, sin tarjeta de crédito. Agrega un espacio vacío para los docs importados.
- Importa el repositorio. Abre el espacio y elige Import from GitBook (así aparece en la app). Pega la dirección del repositorio (
owner/repofunciona) y, si el repositorio es privado, un token de GitHub con el alcancerepo. El token se usa una sola vez y no se guarda. - Revisa las páginas. Comprueba el orden de las páginas, las imágenes y cualquier página que use bloques propios de GitBook, como pestañas o avisos. El importador convierte Markdown estándar, así que los bloques especiales son las páginas que más conviene revisar.
- Publica. Comparte la dirección de OpenDocs o pon el espacio en tu propio dominio (Pro). Mantén tu sitio de GitBook activo hasta que estés conforme.
Qué se traslada y qué no
| Elemento | En la importación |
|---|---|
| Contenido de las páginas (Markdown) | Se convierte en páginas de OpenDocs |
| Orden de las páginas y jerarquía padre/hijo | Se conservan, a partir de la tabla de contenido de SUMMARY.md |
| Front matter al inicio de un archivo | Se elimina |
| Imágenes | Se enlazan desde tu repositorio de GitHub, así que mantén el repositorio disponible |
| Estado de las páginas | Las páginas importadas se publican de inmediato |
| Archivos que no se pueden obtener | Se informan en una lista y el resto se importa igual |
| Usuarios, comentarios, analíticas e integraciones | No forman parte del repositorio, así que configúralos en OpenDocs |
Pruébalo sin arriesgar tus docs en vivo
La importación solo lee tu repositorio. Nada cambia en GitBook, así que tus docs actuales siguen en línea mientras revisas el resultado. Como las páginas importadas se publican de inmediato, importa primero a un espacio nuevo y comparte el enlace solo cuando estés listo.
Qué obtienes después de la mudanza
- Docs que Claude y otras herramientas de IA pueden leer. Cada espacio publicado tiene un servidor MCP integrado, un archivo
llms.txty una versión limpia en Markdown de cada página. - Traducciones a 38 idiomas con Claude, usando tu propia clave de API de Anthropic, más tu consumo de Anthropic.
- Sincronización bidireccional con GitHub, para que tu repositorio siga siendo tu fuente de verdad.
- Un plan Gratis que sigue siendo gratis. Después de la prueba Pro de 14 días continúas en el plan Gratis con 1 espacio, con tus docs publicados incluidos.
¿Quieres comparar primero? Lee OpenDocs vs GitBook para ver la comparación lado a lado, incluidos los casos en que GitBook encaja mejor.
Preguntas frecuentes
¿Mi repositorio tiene que ser público?
No. Un repositorio público se importa sin token. Para uno privado, usa un token de GitHub con el alcance repo. Se usa una sola vez para la importación y no se guarda.
Mi repositorio no tiene SUMMARY.md. ¿Puedo importarlo igual?
El importador arma el árbol de páginas a partir de SUMMARY.md, que GitBook crea al sincronizar un espacio. Sin ese archivo se detiene y te lo avisa, así que nunca queda una importación a medias.
¿Mis imágenes seguirán funcionando?
Sí, mientras el repositorio siga disponible. Las imágenes se enlazan desde GitHub en lugar de copiarse.
¿Puedo volver a importar más adelante?
Sí. Importa a un espacio nuevo cuando quieras una copia fresca.