EPUBCheck は EPUB の規格違反を見つける公式の検査器で、java -jar epubcheck.jar 本.epub で動きます。日本語の環境では結果も日本語で出ますが、メッセージは短く、どこを直せばよいかまでは書かれていません。KDP(Kindle ダイレクト・パブリッシング)に入れる EPUB は EPUBCheck を通すのが前提ですが、Kindle Previewer 4 は EPUBCheck が止めるファイルの多くを「Success・Error Count 0」で通してしまい、逆に EPUBCheck 0 件でも中身を黙って変えることがあります。
この頁は、同じ縦書きの原稿を意図的に壊して EPUBCheck 5.2.1 と Kindle Previewer 4.0.0 の両方にかけた実測(2026 年 10 月〜11 月・計 100 本以上)から、実際に出た 18 本の番号を取り上げます。各項目は「メッセージ(原文)→ 何が起きているか → 直し方 → Previewer はどうするか」の順です。番号は「種類-3 桁」で、RSC は参照・リソース、OPF はパッケージ文書(content.opf)、PKG は zip 容器、NAV は目次文書を指します。
Previewer 側の番号(E21011・W14001 など)から引きたい時は EPUB 入稿前検品の番号表 を見てください。 Previewer の番号ごとに、同じ本を EPUBCheck 5.2.1 に通すと何番で止まるか(止まらず 0 件になる型も明示)を並べた索引は、Zenn 本『縦書きEPUBがKDPプレビューで崩れる7つの原因と直し方』§1(無料)の『Kindle Previewer の番号から引く』13 行にあります。
-u を付けた時だけ出ます。ファイル(行,桁) の形。chap02.xhtml(10,1837) なら 10 行目の 1,837 桁目です。1 行に本文を詰めた XHTML では桁の方が手がかりになります。同じ XHTML の中に同じ id が 2 回あります。脚注を Word から変換した時に fn1 や fnref1 が章ごとに振り直されて重複する形が最も多いです。RSC-005 は「スキーマに合わない」をまとめて指す番号なので、後ろの文で原因を読みます。
id をファイル内で一意にします(fn1・fn2…)。大文字小文字の違いだけ(fn1 と FN1)は EPUBCheck は通しますが、Previewer は同じ id として扱うので、やはり別の名前にします。存在しない要素名や、置けない場所に置いた要素です。見出しは h1〜h6 までで、h7 は変換ツールが深い見出しを機械的に作った時に出ます。
h6 以下に収めるか、<p class="h7"> のように段落と CSS に直します。content.opf の <metadata> に <dc:language>ja</dc:language> がありません。
dc:identifier・dc:title・dc:language の 3 つは必須です。日本語の本は ja。E23005: メタデータに言語が指定されていません で変換失敗、KPF は作られません。論理目次(nav.xhtml・properties="nav")がありません。手書きの目次ページだけでは目次になりません。nav 文書はあるのに epub:type="toc" が無い時は「Exactly one "toc" nav element must be present」になります。この 2 本は日本語訳が無く英語のまま出ます。
<nav epub:type="toc"> を持つ XHTML を 1 つ作り、manifest に properties="nav" で載せます。href="chap02.xhtml#fn2" の #fn2 に当たる id が、その飛び先のファイルに無い状態です。脚注の参照と注本体の id がずれた時、Word の name 属性が id に変換されなかった時、同じファイル内なのに href に別のファイル名を書いた時に出ます。
id="fn2" が実在するか見ます。無ければ注本体に id を付けます。日本語の id は使わず、半角英数にします。本文の src や href が指すファイルが zip の中にありません。manifest に書いたのに無い場合は RSC-001 で、こちらは本文から参照したのに無い場合です。両方出ることもあります。a href のリンク先の XHTML は、zip にあっても manifest に無ければこの番号になります(画像や CSS なら RSC-008)。
.jpg と .jpeg)・フォルダ名を本文の記述と合わせて zip に入れます。W14010 だけが出て、その箇所は壊れ画像の印になります。リンクなら W14001+W14002 が出て、リンク文字は残り、飛び先は無いままです。ファイルは zip の中にあるのに、manifest に item の行が無い形です。図を後から足して manifest を書き忘れた、CSS を 2 本目に増やした、フォントを入れたが manifest に載せなかった、という時に出ます。RSC-007(ファイルそのものが無い)と対になる番号ですが、出るのは img・link・audio など埋め込みの参照だけです。a href のリンク先の XHTML が manifest に無い時は、zip にあっても RSC-007 の方で出ます(EPUBCheck はリンク先を manifest の中からしか探さないため)。
<item id="fig1" href="fig1.png" media-type="image/png"/> のように 1 行足します。media-type は中身に合わせます(CSS は text/css・TTF は font/ttf)。注をまとめた notes.xhtml などを manifest には載せたのに spine(読み順)に載せていない状態で、本文からそこへリンクしています。
<spine> に <itemref idref="notes"/> を足します。読み順に出したくない時は linear="no" を付けます。XML として読めません。この原文は epub:type を使っているのに <html> に xmlns:epub="http://www.idpf.org/2007/ops" が無い形です。閉じタグの欠落(</p> 無し)も同じ FATAL になります。
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops"> にします。閉じタグはエディタの XML 整形で見つけます。ファイル名に空白があります。href に空白をそのまま書くと RSC-020(ERROR)、%20 に符号化しても PKG-010(WARNING「古いリーダーとの相互運用性に問題」)は残ります。
end-notes.xhtml のように空白なしにし、manifest と href を全部書き換えます。+ で置き換えるのは URL では別の意味になるので使いません。%25(二重符号化)になっていると注の参照を結ばず段落にします。XHTML の先頭宣言が encoding="Shift_JIS" のまま、または実際の文字コードが Shift_JIS です。古い Word やテキストエディタの保存設定で起きます。
<?xml version="1.0" encoding="UTF-8"?> にします。CSS も UTF-8 にします。EPUB が標準で許す画像は JPEG・PNG・GIF・SVG(と WebP)だけです。TIFF・BMP はフォールバック(代替画像)が無いと ERROR です。
src と manifest の media-type を直します。W14012 を出し、その図は壊れ画像の印に差し替えられて本に入りません。WebP は逆向きの穴で、EPUBCheck は 0 件のまま Previewer が W14012 と W14015 を 2 行で出し、図が本から消えます(alt の文字も残りません)。EPUB 入稿前検品 は TIFF を『落ちる 1 段-6(本文画像が TIFF/BMP)』、WebP を『黙って変わる 2 段-対照(WebP の図)』の行で止めます。拡張子と中身が違います。JPEG の中身を .png に改名した、PNG を .jpg で保存した、フォントに image/png を書いた、などです。フォントの場合は PKG-021「壊れた画像ファイルがありました」も一緒に出ます。
media-type を直します(JPEG は image/jpeg・PNG は image/png・TTF は font/ttf・OTF は font/otf)。media-type が正しくても拡張子が .ttf/.otf でないと注意ゼロで捨てられ、本は既定の書体で出ます。 フォント 16 通り(.woff・難読化・family 名の綴り違い)の実測と直し方は Zenn 本 §1(無料)の行 29 から §3 ⑬ へ引けます。spine の idref が manifest に無い id を指しています。章を削った後に spine だけ残った形です。RSC-005・RSC-011 も同時に出ます。
itemref を消すか、manifest に該当 item を足します。E20004: spine 中のID がマニフェストのどの項目とも一致しません のエラー行が残ります。Summary 画面だけ見ていると気付きません。manifest に書いたファイルが zip の中に無い形です。章を 1 つ消したのに manifest と spine の行を残した、ファイル名の綴りや大文字小文字が manifest と違う、CSS の実体を入れ忘れた、という時に出ます。本文からの参照が無いファイルなら RSC-007 は出ず、この番号だけになります。
item と spine の itemref の両方を消します。綴り違いは manifest 側を実ファイル名に合わせます。本文ファイルの media-type が application/xhtml+xml ではありません。HTML をそのまま入れた時に出ます。
media-type="application/xhtml+xml" にし、中身も XHTML(閉じタグ・小文字の要素名)にそろえます。本文の XHTML にインライン SVG や MathML があるのに、manifest の item に properties="svg"(mathml)が無い状態です。
<item> に properties="svg" を足します。複数なら空白区切り(properties="svg mathml")。<object> に入れた SVG と、SVG に <img> の代替を置かない形は、注意ゼロでその位置の図が消えます。EPUB 入稿前検品 がその行を拾います。 外字 16 通り・PUA 14 通り・<object> の実測は Zenn 本 §1(無料)の行 30 から §3 ⑭ へ引けます。-u 指定時のみ)zip の中にあるのに manifest に載っていないファイルです。既定では表示されず、-u を付けた時に USAGE として出ます。入稿を止める番号ではありませんが、消したつもりの旧版の章や、macOS の Finder が足す .DS_Store が残っている印です。
EPUB は zip の先頭エントリが mimetype でなければなりません。フォルダを右クリックで圧縮した、zip -r で一括圧縮した、macOS の Finder や ditto で固めた、という時は順番が守られずこの番号になります。__MACOSX フォルダが入っているのも同じ経路の印です。
mimetype を先に無圧縮で入れ、残りを後から足します。コマンドなら zip -X0 本.epub mimetype の後に zip -Xr9D 本.epub META-INF OEBPS の 2 段です。mimetype が圧縮(deflate)されている、または末尾に改行や BOM が付いています。
zip -X0 で無圧縮・属性なしで入れ、中身は改行なしの application/epub+zip だけにします。mimetype は先頭・無圧縮で入っているのに、zip のエントリに更新日時や所有者を記録する「拡張フィールド」が付いています。コマンドの zip を -X 無しで使うとこうなります(zip -0 本.epub mimetype だけだと 28 バイト付く)。中身は正しいので、見落としやすい番号です。
zip -X0 本.epub mimetype のように -X(拡張属性を書かない)を付けて mimetype だけ入れ直します。残りのファイルは後から zip -Xr9D で足します。nav.xhtml の目次項目の並びが、spine の読み順と食い違っています。章の順番を入れ替えた時に nav だけ古いままだと出ます。
<li> を spine の順に並べ直します。文言も飛び先の見出しとそろえます(文言の食い違いは EPUBCheck 0 件のまま Previewer の目次ボタンに古い題が出ます)。上の 18 本は EPUBCheck が止めてくれる物です。逆に EPUBCheck 0 件・Previewer 注意ゼロのまま、Kindle 向けの変換で中身が変わる型が別に 10 種あります(link した CSS の実体が無い→素組み、同一ファイル内の重複 id→最初の 1 つに結ぶ、break-before: page だけ→改ページが入らない、text-combine-upright: digits→数字が寝たまま、ルビの入れ子→Enhanced Typesetting が外れる、など)。これは EPUB を開いてブラウザの中だけで照合する EPUB 入稿前検品(無料・インストール不要・ファイルは送信しません) で一覧にできます。両方を通してから入稿すると、Previewer の画面を 1 ページずつ見る時間を減らせます。
同じ原稿を 600 本以上に振って Previewer と EPUBCheck にかけたログ、縦書き 3 点セット、Word 原稿側の崩れ所、脚注の 66 通りの実測は Zenn 本『縦書きEPUBがKDPプレビューで崩れる7つの原因と直し方』(§1 の症状→原因→直し方の対応表は無料)にまとめています。