Warum deine HTML-Datei in der iOS-Dateivorschau kaputt aussieht

Was die Dateivorschau wirklich macht

Quick Look – die Systemvorschau hinter diesem Tipp – stellt HTML bewusst eingeschränkt dar. Gebaut ist sie für einen sicheren Blick, nicht für Originaltreue:

• Externe Stylesheets werden nicht geladen – nur Inline-Stile überleben.
• JavaScript läuft nie – alles, was die Seite zur Laufzeit aufbaut, existiert schlicht nicht.
• Über relative Pfade referenzierte Dateien – Bilder, Schriften, andere Seiten – werden nicht aufgelöst.
• Es gibt keine Möglichkeit, einer Seite Netzwerkzugriff zu geben, auch nicht absichtlich.

Diagnose nach Symptom

• Lesbarer Text, null Gestaltung → die Seite nutzt ein externes oder CDN-Stylesheet, das die Vorschau ignoriert hat.
• Komplett leer → die Seite wird von JavaScript aufgebaut (typisch für KI-generierte Apps und Diagrammseiten); ohne Skripte gibt es nichts zu zeigen.
• Roher Code auf dem Bildschirm → die Datei kam als .txt an oder hat unterwegs ihre Endung verloren; ein Umbenennen zurück auf .html stellt die Zuordnung wieder her.
• Kaputte Bildsymbole → die Bilder liegen neben der HTML-Datei; die Vorschau der einzelnen Datei trennt sie davon.
• Zeichensalat (中文/日本語 als Symbole) → die Datei nutzt eine alte Codierung wie GB18030 oder Shift-JIS, die die Vorschau als UTF-8 gelesen hat.

Die Lösung: in einem echten Renderer öffnen

Jeder dieser Fehler verschwindet, sobald die Datei von etwas geöffnet wird, das HTML richtig darstellt. OpenHTML (kostenlos) macht das auf dem Gerät: Teile die Datei dorthin – oder öffne sie einmalig aus „Dateien“, ohne sie zu importieren – und die Seite erscheint mit angewendeten Stilen und laufendem lokalem JavaScript.

• Mehrdatei-Seiten: Importiere den Ordner oder das ZIP, damit relative Pfade weiter funktionieren – siehe ZIP-Web-Projekte auf dem iPhone.
• Alte Codierungen werden automatisch erkannt, damit CJK-Text richtig erscheint.
• Stimmt trotzdem etwas nicht, nennt die Diagnose die genaue fehlende Datei oder blockierte Ressource, statt dich raten zu lassen – und wo möglich folgt eine Ein-Tipp-Lösung.

Anders als die Vorschau lässt dich OpenHTML den Netzwerkzugriff pro Dokument erlauben, wenn eine Seite ihr CDN wirklich braucht – während jede andere Seite vollständig offline bleibt.

Warum nicht einfach Safari?

Safari ist ein hervorragender Renderer, nur gibt es keinen vorgesehenen Weg, ihm eine lokale Datei samt Ressourcen zu übergeben. Umwege existieren, aber jeder hat eine scharfe Kante: Einzelne Dateien öffnen sich manchmal über „Teilen“ → Safari, verlieren dabei aber ihre Nachbarn; und die Datei irgendwo zu hosten macht aus privaten Daten einen Upload. Für Dateien ist eine Viewer-App die langweilige, verlässliche Antwort – der komplette Leitfaden zum Öffnen von HTML auf dem iPhone vergleicht alle Optionen.