Importa desde cualquier herramienta con IA

¿Vienes de Docusaurus, MkDocs, Sphinx, GitBook, VitePress u otra herramienta? Tu agente de programación con IA puede hacer el traslado por ti con la Agent Skill migrate-docs. Convierte tus páginas a DeveloperHub Markdoc, reconstruye tu navegación, copia tus imágenes y te entrega una carpeta para importar con Sincronización con GitHub.

Tu contenido se conserva tal cual. Solo cambia la sintaxis que lo rodea, y tu documentación original nunca se modifica.

Antes de empezar

• Un agente de programación con IA compatible con Agent Skills, como Claude Code, Cursor o Codex.

• Tu documentación en un formato que el agente pueda leer: una carpeta en tu equipo, un repositorio de Git o una exportación de tu herramienta actual. Si no tienes ninguno de estos, el agente puede leer tu sitio publicado, aunque así se conserva menos estructura.

• Un repositorio de GitHub desde el que importar el resultado. Uno nuevo, vacío y privado es suficiente.

Paso 1: Instala las Skills

La skill no viene incluida con tu agente, así que instálala primero. Incluye otras dos skills de las que depende, por lo que debes instalar el paquete completo.

En Claude Code, ejecuta:

En Cursor, Codex u otro agente, ejecuta esto en una terminal:

Después, inicia una nueva sesión en tu agente para que cargue las skills. Para conocer otras formas de instalarlas y cómo mantenerlas actualizadas, consulta Escribir Markdoc con agentes de IA.

Paso 2: Pide a tu agente que migre

Abre tu agente y pídele que traslade tu documentación a DeveloperHub, indicándole dónde está:

También sirve un enlace a un repositorio, un archivo de exportación o la dirección de tu sitio en producción. En Claude Code, también puedes iniciar la skill directamente con /dh-skills:migrate-docs.

Indica al agente dónde guardar el resultado. Si no lo haces, sugerirá una carpeta nueva junto a tu documentación.

Paso 3: Responde sus preguntas

Primero el agente examina tu documentación e informa de lo que ha encontrado: cuántas páginas hay, y las secciones, versiones e idiomas en los que se encuentran. Después te pregunta de una vez sobre todo lo que tu configuración actual no define, como:

• Qué secciones pasan a ser secciones de documentación independientes y cuáles permanecen como grupos en una misma barra lateral.

• Qué versiones e idiomas trasladar.

• Si un blog o las notas de versión se convierten en un registro de cambios.

Cada pregunta incluye una respuesta recomendada, así que puedes responder "usa los valores predeterminados".

Paso 4: Revisa las primeras páginas

Antes de convertirlo todo, el agente convierte entre tres y cinco páginas representativas y te las muestra. Comprueba que se ven bien e indícale qué cambiar. Aplicará tus comentarios al resto de la migración, no solo a esas páginas.

Paso 5: Revisa el resultado

Cuando termina, el agente comprueba su propio resultado y te entrega una carpeta que contiene:

• Tus páginas, navegación e imágenes con la estructura que espera GitHub Sync.

• MIGRATION.md, un informe de lo que se migró, las decisiones tomadas, las páginas cuya dirección cambió y todo lo que requiere tu atención.

• redirects.txt, una lista de redirecciones de las direcciones antiguas de tus páginas a las nuevas.

Lee MIGRATION.md antes de importar. Todo lo que no pudo trasladarse exactamente aparece allí con su archivo y línea, de modo que no se pierde nada sin que lo sepas.

Paso 6: Importa con GitHub Sync

1. Sube la carpeta a tu repositorio de GitHub. Puede estar en la raíz o en una subcarpeta.

2. Configura GitHub Sync con ese repositorio. Si la carpeta está en una subcarpeta, indícala como Base path.

3. Establece First sync en Import y haz clic en Start sync.

4. Cuando termine, revisa la pestaña Activity del panel Docs Sync por si hay advertencias.

Paso 7: Mantén funcionando tus enlaces antiguos

Cuando apuntes tu dominio a DeveloperHub, pega el contenido de redirects.txt en Redirecciones de URL. Así, los enlaces a tus páginas antiguas, desde buscadores y otros sitios, llevarán a las mismas páginas en DeveloperHub.