EPUBCheck · XHTML Inhaltsdokumente

EPUBCheck HTM-001: XML-Version ist nicht 1.0

Aktualisiert: 4. November 2026

EPUBCheck HTM-001 ist eine Fehlermeldung: „Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….“ Eine XML-Datei im EPUB deklariert eine XML-Version, die nicht 1.0 ist. EPUB verlangt, dass jede XML-basierte Ressource (XHTML Kapitel, das Paketdokument, die NCX, SVG-Bilder) ein gültiges XML 1.0 Dokument sein muss, und EPUBCheck nennt die Version, die er gefunden hat.

Die offizielle Nachricht

Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: %1$s.

Standard-Schweregrad: Fehler. Das EPUB bricht eine Regel der Spezifikation und ist ungültig. Geschäfte und Sende an Kindle könnten es ablehnen, und EPUBCheck beendet die Ausführung mit Status 1.
EPUBCheck Version: 5.4.0

%1$s, %2$s… werden mit der Datei, dem Wert oder dem Element EPUBCheck ausgefüllt.

Typische Ursachen

Eine XML-Deklaration, die says version="1.1", geschrieben von einem Editor oder einem Export-Tool, das standardmäßig darauf eingestellt ist.
Eine Vorlage, die aus einem anderen XML-Projekt kopiert und für jedes Kapitel wiederverwendet wurde.

Wie man es behebt

Öffnen Sie die Datei EPUBCheck Namen (die Nachricht gibt den Pfad, die Zeile und die Spalte an) in einem Text- oder EPUB Editor wie Sigil, oder entpacken Sie die EPUB und öffnen Sie sie dort.
Ändern Sie die erste Zeile in <?xml version="1.0" encoding="UTF-8"?> oder entfernen Sie die XML-Deklaration: ohne eine wird XML 1.0 und UTF-8 angenommen.
Wenn das Werkzeug, das das Buch erstellt hat, 1.1 in jeder Datei schreibt, beheben Sie dessen Vorlage, damit der nächste Export korrekt ist.
Rebuild den EPUB und führe EPUBCheck erneut aus, um zu bestätigen, dass die Nachricht verschwunden ist.

Wann es nicht das ist

Wenn die Deklaration 1.0 sagt, die Datei aber in UTF-16 gespeichert ist, ist das HTM_058, nicht HTM-001.

Andere HTM Nachrichten

HTM-003 External entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004 Irregular DOCTYPE: found "…", expected "…".
HTM-007 Empty or whitespace-only value of attribute ssml:ph.
HTM-009 The DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010 Namespace "…" is unusual for the prefix "epub".
HTM-011 Entity is undeclared.

Quellen

EPUB 3.3, §3.9 XML conformance · lesen 4. November 2026

Nachrichtentext und Schweregrad von EPUBCheck 5.4.0 (W3C, BSD-3-Klausel). Erklärung durch EpubCC.

FAQ

Was bedeutet EPUBCheck HTM-001?

Ist HTM-001 ein Fehler?

HTM-001 wird standardmäßig als Fehler gemeldet. Das EPUB verstößt gegen eine Regel der Spezifikation und ist ungültig. Stores und Send to Kindle könnten es zurückweisen, und EPUBCheck beendet mit Status 1.