html2wp / Documentación

Cómo convertir plantilla HTML a WordPress en la app html2wp

Esta guía explica cómo convertir plantilla HTML a WordPress con la app de escritorio html2wp: la instalación, tu primera conversión, la elección del modelo, qué sale de tu equipo y cómo editas el sitio terminado. La conversión con un agente en la terminal está en la documentación del plugin para Claude Code y Codex.

Primera parteTu primera conversión

Instalar la app para convertir plantilla HTML a WordPress

Para convertir plantillas HTML a WordPress, descarga la app html2wp para un Mac con Apple silicon (M1 o posterior) o para Windows. Se instala como cualquier otra aplicación. La versión de Windows todavía es una Preview (versión preliminar), y la de Linux llegará más adelante.

La primera vez que la abras, haz clic en "Prepare environment" (preparar el entorno). Entonces la app descarga todo lo que necesita. Solo lo hace una vez, y tarda un rato.

Para trabajar, la app necesita Docker Desktop, un programa gratuito. Docker ejecuta un WordPress temporal, y la app instala ahí el tema y lo revisa. Si no tienes Docker, la app lo descarga y abre el instalador por ti. Puede que tu equipo te pida la contraseña durante el proceso.

Iniciar sesión con ChatGPT

La conversión la hace la IA de tu suscripción de ChatGPT, así que no nos pagas créditos ni tokens.

En la app, haz clic en "Connect with ChatGPT". La app te muestra un código de 9 caracteres y abre una página de OpenAI en tu navegador. Ahí eliges tu cuenta de ChatGPT o inicias sesión.

A continuación la página te pide un código "de la terminal" y menciona Codex CLI. Es correcto: html2wp usa Codex, y el código que pide la página es el de la app. Pégalo (haz clic en el código de la app para copiarlo) y pulsa "Continue". Cuando inicias sesión, la app se actualiza sola.

Tu contraseña solo la ve OpenAI

Escribes la contraseña de ChatGPT únicamente en la página de OpenAI, y la app nunca la ve. No envíes el código a nadie, e introdúcelo solo cuando hayas iniciado tú el acceso.

Proyecto nuevo: la plantilla HTML que conviertes en tema de WordPress

Haz clic en "New project" y elige la carpeta o el ZIP con tu sitio. Puede ser una exportación de Lovable, Bolt o v0, un diseño de Claude o un sitio en HTML simple. La app no acepta la dirección de un sitio (URL), porque necesita los archivos de los que está hecho.

La app averigua por sí sola qué página es la de inicio y cuál es el blog, un artículo o un producto.

Después eliges qué quieres obtener. Lo normal es convertir la plantilla HTML en un tema de WordPress, en modo Flash o Full. Si no necesitas WordPress, elige en su lugar un proyecto Astro 5. Esa conversión es más corta, y puedes publicar el sitio terminado directamente desde la app en Cloudflare Pages, donde puedes alojarlo gratis.

Flash o Full: dos formas de convertir plantilla HTML a WordPress

Flash es la conversión rápida, y es la opción por defecto en la app. Cada paso se ejecuta una vez. Los menús, el blog, la tienda y los formularios se reconocen y se conectan de inmediato. Las comprobaciones también se ejecutan una vez, y sus resultados aparecen en el informe. Tarda una media hora y sirve para la mayoría de los sitios, y también para una prueba rápida.

Full es la conversión a fondo. Ejecuta todas las comprobaciones e intenta corregir los errores que encuentra. Tarda alrededor de una hora y consume más del límite de tu suscripción de ChatGPT. Por eso compensa en sitios más complejos, o cuando Flash dejó muchos puntos por pulir en el informe.

Los dos modos sirven para convertir tu plantilla HTML en un tema de WordPress utilizable, y añaden una nota sobre lo que quede pendiente. El tiempo exacto depende del número de páginas y de la velocidad de tu equipo.

Qué modelo elegir para convertir plantilla HTML a WordPress

En la app eliges el modelo de IA y el nivel de razonamiento ("Reasoning effort").

  • GPT-6-Luna en Extra high basta para las conversiones habituales. Es barato, gasta poco del límite de tu suscripción y resuelve solo la mayoría de los sitios.
  • GPT-6-Sol en Medium o High es el que recomendamos cuando hay algo que corregir, por ejemplo en una conversión Full o para cambios a través del chat.
  • GPT-6-Astra es el modelo más potente y el más caro. No lo necesitas para el trabajo normal, pero ayuda cuando ni siquiera Sol resuelve un problema.

Puedes cambiar de modelo siempre que no haya una conversión en marcha. Cada proyecto puede tener el suyo.

Revisar el tema de WordPress frente a tu plantilla HTML

Cuando termina la conversión, la app te avisa. Si algo no sale bien, primero intenta arreglarlo por su cuenta. En cualquier caso, siempre entrega un tema utilizable con una nota sobre lo que falta pulir.

En la pestaña "Preview", haz clic en "Open website" y mira el sitio nuevo en tu navegador. La pestaña "Compare" muestra el original y la conversión uno al lado del otro, con la diferencia en porcentaje. Escribe en el chat lo que no te guste, y la app lo corrige. Luego guarda los cambios terminados como una versión nueva con "Make release".

Las comprobaciones automáticas detectan la mayoría de las diferencias, pero no todas. Por eso conviene que repases las páginas antes de entregar el tema a un cliente. El ZIP del tema lo guardas en la pestaña "Exports" y lo subes a WordPress en Apariencia → Temas → Añadir nuevo → Subir tema.

Segunda parteDespués

Datos y privacidad

Nuestro servidor construye el tema. Pero la mayor parte del trabajo (medir, comparar con el original y corregir) se ejecuta en tu equipo, y la dirige la IA de tu cuenta de ChatGPT. OpenAI trata aquello con lo que trabaja la IA según las condiciones de tu cuenta.

Qué se envía al servidor

Tu sitio convertido en un proyecto Astro (páginas, estilos, scripts, imágenes y fuentes), más información sobre cada página. No se envían la carpeta original del proyecto ni las librerías instaladas (node_modules). Los datos subidos se borran automáticamente a las 48 horas. Solo queda una huella (hash), y gracias a ella una repetición cuenta como una sola conversión.

Archivos con contraseñas y claves

Los archivos que parecen credenciales de acceso nunca entran en el paquete: .env, claves (.pem, .key, id_rsa), .npmrc, .netrc, las carpetas .ssh y .aws, ni ningún archivo con una clave privada. Todo lo que la app dejó fuera aparece en el informe, con su nombre.

Resultados de las comprobaciones

Después de probar el tema, la app envía solo los resultados de las comprobaciones: cuáles pasaron y cuáles no, el número de páginas, la mayor diferencia con el original y los nombres cortos de las páginas que fallaron (por ejemplo "about"). No envía la dirección del sitio, el dominio, el código, los textos, las capturas, las rutas de archivos, la clave de licencia ni el nombre del sitio.

Las comprobaciones se ejecutan contra el WordPress de tu equipo, que nuestro servidor nunca ve. Sin sus resultados, el servidor solo sabría que la conversión no se colgó. Por eso la siguiente conversión empieza solo cuando la anterior ha enviado sus resultados. La app los envía automáticamente. La descripción completa está en la página de privacidad.

Editar con Visual Edit

Al convertir una plantilla HTML en un tema de WordPress, el sitio resultante no necesita ningún plugin para funcionar. Las páginas, el blog, los formularios, los menús, el SEO y las redirecciones forman parte del tema. Las redirecciones llevan las direcciones antiguas a las nuevas: quien abre el enlace antiguo /about.html llega a /about/, así que el sitio conserva sus posiciones en los buscadores.

La edición con clics la aporta Visual Edit, un plugin de WordPress que añades tú. Lo que cambia es justo aquello en lo que haces clic. Ningún maquetador visual reconstruye por debajo el código de la página.

FunciónLite (gratis)Pro
Textos, imágenes y enlaces con un clic✓✓
Formularios, menús y campos de SEO✓✓
Historial de cambios10 pasos300 pasos
Asistente de IA (con tu propia clave de API de OpenRouter)–✓
Edición de imágenes con IA y animaciones a partir de imágenes–✓
Exportación del tema y protección de formularios con Turnstile–✓

Pro es una licencia anual aparte que encuentras en la página de precios. Cada conversión, Free o Pro, enlaza a la versión gratuita Lite. Si desactivas el plugin, las páginas se siguen mostrando y el tema sigue siendo totalmente utilizable.

Licencia, suscripción, beta

Repeticiones

En el plan gratuito tienes 5 repeticiones en total entre todas las conversiones, y con una licencia Pro son ilimitadas. Una repetición es el mismo sitio subido de nuevo. El servidor lo reconoce por su huella (hash), así que cuenta como repetición y no como conversión nueva.

Gestionar y cancelar la suscripción

Tu suscripción la gestionas en la página de la suscripción. El enlace está en el pie del sitio y en cada correo de licencia. En el portal de cliente de Paddle puedes cancelar la suscripción, cambiar la tarjeta, descargar facturas y pasar Pro de mensual a anual. El portal te deja entrar con un enlace que llega al correo con el que compraste, así que no necesitas contraseña.

Cancelar detiene la próxima renovación. Tu clave funciona hasta el final del periodo pagado, y todos los temas que convertiste siguen siendo tuyos. Cancelar no es un reembolso: los reembolsos siguen las condiciones de reembolso.

Qué significa beta

La app compara cada página con el original a 1440 y 390 px y anota en el informe cada diferencia que encuentra. Una comprobación que falla va al informe, y recibes el mejor tema utilizable con una descripción de lo que falta por ajustar. Revisa las páginas señaladas antes de prometerle un resultado a un cliente.

Si encuentras un error en el propio conversor, infórmalo como explica la documentación del plugin. Lo lee una persona, y las correcciones llegan como actualizaciones del servicio.