html2wp / Dokumentation
HTML in ein WordPress-Theme umwandeln: Anleitung für die html2wp-App
Diese Anleitung zeigt, wie du in der Desktop-App von html2wp HTML in ein WordPress-Theme umwandelst. Sie erklärt jeden Schritt: die Installation der App, deine erste Konvertierung, die Wahl des Modells, was deinen Computer verlässt und wie du die fertige Website bearbeitest. Die Konvertierung mit einem Agenten im Terminal erklärt die Dokumentation zum Plugin für Claude Code und Codex.
Die App installieren, die HTML in ein WordPress-Theme umwandelt
Lade die App html2wp für einen Mac mit Apple Silicon (M1 oder neuer) oder für Windows herunter und installiere sie wie jedes andere Programm. Die Windows-Version ist noch eine Vorschau, eine Linux-Version kommt später.
Klicke, sobald du die App zum ersten Mal öffnest, auf „Prepare environment“ (Umgebung vorbereiten). Die App lädt dann alles herunter, was sie braucht. Das passiert nur einmal und dauert eine Weile.
Für ihre Arbeit braucht die App Docker Desktop, ein kostenloses Programm. Docker betreibt ein temporäres WordPress, in das die App das Theme installiert und dort prüft. Wenn du kein Docker hast, lädt die App es herunter und startet für dich das Installationsprogramm. Dein Computer fragt unterwegs vielleicht nach deinem Passwort.
Mit ChatGPT anmelden
Die Konvertierung macht die KI aus deinem ChatGPT-Abo. Du zahlst uns deshalb nichts für Credits oder Tokens.
Klicke in der App auf „Connect with ChatGPT“. Die App zeigt dir einen Code aus 9 Zeichen und öffnet eine Seite von OpenAI in deinem Browser. Dort wählst du dein ChatGPT-Konto oder meldest dich an.
Als Nächstes fragt die Seite nach einem Code „aus dem Terminal“ und erwähnt Codex CLI. Das passt: html2wp nutzt Codex, und der Code, den die Seite will, ist der aus der App. Füge ihn ein (ein Klick auf den Code in der App kopiert ihn) und klicke auf „Continue“. Nach der Anmeldung aktualisiert sich die App von selbst.
Dein Passwort sieht nur OpenAI
Dein ChatGPT-Passwort tippst du nur auf der Seite von OpenAI ein, und die App sieht es nie. Schick den Code an niemanden und gib ihn nur ein, wenn du die Anmeldung selbst gestartet hast.
Neues Projekt: das HTML, aus dem dein WordPress-Theme wird
Klicke auf „New project“ und wähle den Ordner oder die ZIP-Datei mit deiner Website. Das kann ein Export aus Lovable, Bolt oder v0 sein, ein Design aus Claude oder eine reine HTML-Website. Eine Adresse (URL) nimmt die App nicht an, denn sie braucht die Dateien, aus denen die Website gebaut ist.
Welche Seite die Startseite ist und welche der Blog, ein Artikel oder ein Produkt, ermittelt die App selbst, ohne dich zu fragen.
Dann wählst du, was du bekommen willst. Meist wandelst du das HTML in ein WordPress-Theme um, im Modus Flash oder Full. Brauchst du kein WordPress, wähle stattdessen ein Astro-5-Projekt. Diese Konvertierung ist kürzer, und die fertige Website kannst du direkt aus der App auf Cloudflare Pages veröffentlichen, wo du sie kostenlos hosten kannst.
Flash oder Full: zwei Wege, HTML in ein WordPress-Theme umzuwandeln
Flash ist die schnelle Konvertierung und in der App voreingestellt. Jeder Schritt läuft einmal. Menüs, Blog, Shop und Formulare werden sofort erkannt und verknüpft, ohne zweiten Durchlauf. Auch die Prüfungen laufen nur einmal, ihre Ergebnisse findest du im Bericht. Flash dauert etwa 30 Minuten und passt für die meisten Websites und für einen schnellen Test.
Full ist die gründliche Konvertierung. Sie führt jede Prüfung aus und versucht, gefundene Fehler zu beheben. Sie dauert etwa eine Stunde und verbraucht mehr vom Limit deines ChatGPT-Abos. Deshalb lohnt sie sich für komplexere Websites oder wenn Flash im Bericht viele Punkte zum Nachbessern hinterlassen hat.
Beide Modi wandeln dein HTML in ein nutzbares WordPress-Theme um und vermerken, was noch offen ist. Die genaue Dauer hängt von der Anzahl der Seiten und vom Tempo deines Computers ab.
Ein Modell wählen, um HTML in ein Theme umzuwandeln
In der App wählst du das KI-Modell und die Denkstufe („Reasoning effort“).
- GPT-6-Luna auf „Extra high“ reicht für normale Konvertierungen. Es kostet wenig, verbraucht wenig vom Limit deines Abos und schafft die meisten Websites allein.
- GPT-6-Sol auf „Medium“ oder „High“ empfehlen wir, wenn etwas zu beheben ist, zum Beispiel bei einer Konvertierung mit Full oder bei Änderungen über den Chat.
- GPT-6-Astra ist das stärkste und teuerste Modell. Für normale Arbeit brauchst du es nicht, aber es hilft, wenn selbst Sol ein Problem nicht löst.
Das Modell kannst du wechseln, wann immer keine Konvertierung läuft. Jedes Projekt kann sein eigenes haben.
Das WordPress-Theme mit deinem HTML vergleichen
Wenn die Konvertierung fertig ist, gibt dir die App Bescheid. Klappt etwas nicht, versucht sie zuerst, es selbst zu beheben. In jedem Fall übergibt sie immer ein nutzbares Theme mit einem Hinweis, was noch nachzubessern ist.
Klicke im Tab „Preview“ (Vorschau) auf „Open website“ und sieh dir die neue Website im Browser an. Der Tab „Compare“ (Vergleich) zeigt Original und Konvertierung nebeneinander, mit der Abweichung in Prozent. Schreib in den Chat, was dir nicht gefällt, und die App behebt es. Dann speicherst du die fertigen Änderungen mit „Make release“ als neue Version.
Die automatischen Prüfungen finden die meisten Abweichungen, aber nicht alle. Sieh dir die Seiten deshalb an, bevor du das Theme einem Kunden gibst. Die Theme-ZIP speicherst du im Tab „Exports“ und lädst sie in WordPress unter Design → Themes → Theme hinzufügen → Theme hochladen hoch.
Daten und Datenschutz
Das Theme baut unser Server. Der Großteil der Arbeit (Messen, Vergleichen mit dem Original und Korrigieren) läuft aber auf deinem Computer, gesteuert von der KI in deinem ChatGPT-Konto. OpenAI verarbeitet, woran die KI arbeitet, nach den Bedingungen deines Kontos.
Was an den Server geht
Deine Website, umgewandelt in ein Astro-Projekt (Seiten, Styles, Skripte, Bilder und Schriften), dazu Informationen zu jeder Seite. Der ursprüngliche Projektordner und die installierten Bibliotheken (node_modules) werden nicht gesendet. Die hochgeladenen Daten werden nach 48 Stunden automatisch gelöscht. Nur ein Fingerabdruck (Hash) bleibt, und dadurch zählt ein erneuter Lauf als eine Konvertierung.
Dateien mit Passwörtern und Schlüsseln
Dateien, die wie Zugangsdaten aussehen, kommen gar nicht erst ins Paket: .env, Schlüssel (.pem, .key, id_rsa), .npmrc, .netrc, die Ordner .ssh und .aws und jede Datei mit einem privaten Schlüssel. Alles, was die App weggelassen hat, findest du mit Namen im Bericht.
Ergebnisse der Prüfungen
Nachdem sie das Theme getestet hat, sendet die App nur die Ergebnisse der Prüfungen. Das sind: welche Prüfungen bestanden wurden und welche nicht, Seitenzahlen, die größte Abweichung vom Original und die kurzen Namen der durchgefallenen Seiten (zum Beispiel „about“). Die Adresse der Website, Domain, Code, Text, Screenshots, Dateipfade, Lizenzschlüssel und den Namen der Website sendet sie nicht.
Die Prüfungen laufen gegen das WordPress auf deinem Computer, das unser Server nie sieht. Ohne ihre Ergebnisse wüsste der Server nur, dass die Konvertierung nicht abgestürzt ist. Deshalb startet die nächste Konvertierung erst, wenn die vorherige ihre Ergebnisse gesendet hat. Die App sendet sie automatisch. Die vollständige Beschreibung steht auf der Seite zum Datenschutz.
Mit Visual Edit bearbeiten
Eine Website, die du aus HTML in ein WordPress-Theme umwandelst, braucht zum Laufen kein Plugin. Seiten, Blog, Formulare, Menüs, SEO und Weiterleitungen sind alle Teil des Themes. Die Weiterleitungen schicken alte Adressen auf neue: Wer den alten Link /about.html öffnet, landet auf /about/. So behält die Website ihre Positionen in der Suche.
Das Bearbeiten per Klick kommt von Visual Edit, einem WordPress-Plugin, das du selbst hinzufügst. Was du anklickst, ändert sich. Kein Page Builder baut darunter den Code der Seite um.
| Funktion | Lite (kostenlos) | Pro |
|---|---|---|
| Text, Bilder und Links per Klick | ✓ | ✓ |
| Formulare, Menüs und SEO-Felder | ✓ | ✓ |
| Bearbeitungsverlauf | 10 Schritte | 300 Schritte |
| KI-Assistent (dein eigener API-Schlüssel für OpenRouter) | – | ✓ |
| Bildbearbeitung mit KI und Animationen aus Bildern | – | ✓ |
| Theme-Export und Formularschutz mit Turnstile | – | ✓ |
Pro ist eine eigene Jahreslizenz auf der Preisseite. Jede Konvertierung, ob Free oder Pro, verlinkt auf die kostenlose Version Lite. Schaltest du das Plugin ab, werden die Seiten weiter angezeigt, und das Theme bleibt voll nutzbar.
Lizenz, Abo, Beta
Erneute Läufe
In der Gratis-Version hast du insgesamt 5 erneute Läufe über alle Konvertierungen, mit einer Pro-Lizenz sind sie unbegrenzt. Ein erneuter Lauf ist dieselbe Website, noch einmal hochgeladen. Der Server erkennt sie an ihrem Fingerabdruck (Hash), also zählt sie als erneuter Lauf, nicht als neue Konvertierung.
Dein Abo verwalten und kündigen
Dein Abo verwaltest du auf der Seite zum Abo. Der Link steht in der Fußzeile der Website und in jeder E-Mail zur Lizenz. Im Kundenportal von Paddle kannst du das Abo kündigen, die Karte ändern, Rechnungen herunterladen und monatliches Pro auf jährliches umstellen. Du meldest dich dort über einen Link an, der an die E-Mail geht, mit der du gekauft hast. Ein Passwort brauchst du also nicht.
Eine Kündigung stoppt die nächste Verlängerung. Dein Schlüssel funktioniert bis zum Ende des bezahlten Zeitraums, und jedes Theme, das du konvertiert hast, bleibt deins. Eine Kündigung ist keine Rückerstattung: Rückerstattungen folgen den Bedingungen zur Rückerstattung.
Was Beta bedeutet
Die App konvertiert echte Websites für echte Arbeit. Sie vergleicht jede Seite bei 1440 und 390 px mit dem Original und listet jede gefundene Abweichung im Bericht auf. Dazu übergibt sie das beste nutzbare Theme mit einer Beschreibung, was noch nachzubessern ist. Sieh dir die markierten Seiten an, bevor du einem Kunden ein Ergebnis zusagst.
Findest du einen Fehler im Konverter selbst, melde ihn so, wie es die Dokumentation zum Plugin beschreibt. Ein Mensch liest die Meldung, und Korrekturen kommen als Updates des Dienstes.