はてなブログのエクスポート(MT形式)を静的HTMLに変換するスクリプト hatena2static.py の使い方です。
--markdown を使うときだけ pip install markdown が必要です。hatena2static.py と同じフォルダにエクスポートファイルを置きます。python3 hatena2static.py export.txt -o site --title "ブログ名"
site/index.html をブラウザで開いて確認します。# 自分のブログのURLを明示する(独自ドメインの場合など。複数指定可)
python3 hatena2static.py export.txt --blog-url https://example.hatenablog.com
# まずネットワークなしで動作確認(外部URLはリンクのみ)
python3 hatena2static.py export.txt --no-fetch
# 前回OGP取得に失敗したURLをやり直す
python3 hatena2static.py export.txt --retry-failed
# 本文がMarkdownの場合
pip install markdown
python3 hatena2static.py export.txt --markdown
--blog-url を指定してください。hatenablog-parts.com のiframeと、[URL:embed] の記法の両方を検出します。
| 元のURL | 処理 |
|---|---|
| 自分のブログの記事 | OGPは取得せず、ローカルへの相対パスに書き換えます。タイトル、冒頭文、日付、サムネイル画像は、書き出す記事から作ります。サムネイルは、はてなブログで設定したアイキャッチ画像(エクスポートの IMAGE: 行)を優先し、なければ本文の最初の画像を使います。 |
| 外部サイト | OGP(タイトル・説明・画像・サイト名)を取得して、静的なカードHTMLにします。 |
| OGP取得に失敗 | 通常のリンクにします。 |
| 自分のブログだが書き出し対象外 | 元URLの通常リンクにします(/archive/... や下書きなど)。 |
本文中の通常の <a href="自分の記事URL"> も、ローカルのパスに書き換えます。URL末尾の #アンカー は保持されます。
取得結果は ogp_cache.json に保存されます。再実行時は成功済みのURLを再取得しないので、2回目以降は速くなります。失敗したURLは記録され、--retry-failed を付けたときだけ再試行します。
| オプション | 説明 | 既定値 |
|---|---|---|
input | MT形式のエクスポートファイル(必須) | - |
-o, --output | 出力ディレクトリ | site |
--title | サイトのタイトル | マイブログ |
--blog-url | 自分のブログのURLまたはホスト名(複数指定可) | 自動判定 |
--no-fetch | OGPを取得しない | 取得する |
--retry-failed | 前回失敗したURLを再試行 | しない |
--cache | OGPキャッシュファイル | ogp_cache.json |
--workers | OGP取得の並列数 | 4 |
--delay | 各リクエスト前の待機秒数 | 0.3 |
--timeout | OGP取得のタイムアウト秒数 | 10 |
--card-date-format | 内部記事カードに表示する日付の書式(例: "%Y年%m月%d日") | %Y-%m-%d |
--list-date-format | 一覧ページの日付の書式 | %Y/%m/%d |
--markdown | 本文をMarkdownとして変換 | しない |
外部URLが多い場合は、相手サーバーへの負荷を抑えるために --workers を減らすか --delay を増やしてください。
トップページとカテゴリ別ページには、それぞれ「テキスト一覧」と「画像付き一覧」があります。画面上部の「テキスト一覧 | 画像付き一覧」のリンクで、相互に切り替えられます。
index.html / index_image.html: 全記事の一覧です。表の上に、カテゴリ一覧(記事数つき)があります。category/c1.html / category/c1_image.html: カテゴリごとの一覧です。テキスト一覧は「カテゴリー」と「記事」の2列、画像付き一覧は「カテゴリー」と「記事」の間に、アイキャッチ画像の列を加えた表です。記事は新しい順で、タイトル(リンク)の後ろに、赤い文字で日付を表示します。
エクスポートの IMAGE: 行(はてなブログで設定したアイキャッチ画像)を使います。ない記事は、本文の最初の画像を使います。どちらもない記事は、薄い灰色の枠を表示します。
一覧ページの画像は、横×縦が4:3になるように、はみ出す部分を切り抜いて表示します(PCもスマホも同じ比率)。記事内のブログカードの画像は、横×縦が3:4(縦長)で、カードの右側いっぱいに表示します(カードの高さは画像がある場合132px固定、本文は最大2行)。比率を変えたいときは、style.css の aspect-ratio(一覧は td.col-img img、カードは .lc-thumb img)を編集してください。
右上の検索ボックスに入力すると、カテゴリ・タイトル・日付を対象に、入力と同時に絞り込みます。一致した部分は、黄色の背景で強調されます。
野鳥 北海道)。2026/11/15)のほか、2026-11-15 や 2026年11月15日 の形でも検索できます。年や年月だけ(例: 2026/11、2026年11月)でも絞り込めます。?q=検索語 として反映されます。このURLを開くと、その検索語で絞り込んだ状態で表示されるので、検索結果をブックマークしたり、人に伝えたりできます(例: index.html?q=野鳥%202026/11)。一覧の日付の書式は --list-date-format で変えられます。
style.css の article h1 の font-size を編集してください。site/
├── index.html トップ(テキスト一覧・検索)
├── index_image.html トップ(アイキャッチ画像つき一覧・検索)
├── style.css 共通スタイル(ダークモード対応)
├── category/
│ ├── c1.html カテゴリ別の一覧(テキスト)
│ ├── c1_image.html カテゴリ別の一覧(画像付き)
│ └── c2.html ...
└── entry/
└── 2020/01/01/123456.html 記事(元の /entry/ 以下と同じ階層)
リンクはすべて相対パスなので、フォルダごと別の場所に移しても動作します。下書き(STATUS: Draft)は出力されません。
site/ フォルダの中身を、GitHub Pages、Cloudflare Pages、Netlifyなどの静的ホスティングにアップロードします。
元のURL(/entry/2020/01/01/123456)と同じ形で配信したい場合は、.html を付けないURLで配信できるホストを選んでください。上記3つはこれに対応しています。
公開状態(STATUS: Publish)の記事だけが対象です。ファイルがMT形式のエクスポートか、文字コードがUTF-8かを確認してください。
自分のブログのホストが正しく判定されていない可能性があります。実行時のメッセージを確認し、--blog-url で指定してください。独自ドメインとはてなのドメインの両方で記事が参照されている場合は、両方を指定します。
python3 hatena2static.py export.txt \
--blog-url https://example.hatenablog.com \
--blog-url https://blog.example.com
相手サイトが閉鎖している、ボットのアクセスを拒否している、タイムアウトした、などの理由で取得に失敗しています。--timeout を増やして --retry-failed で再試行してみてください。取得結果は ogp_cache.json で確認できます。
本文中の画像と、カードのOGP画像は、外部のURLを直接参照します。はてなフォトライフの終了や、相手サイトの画像削除で表示されなくなる可能性があります。長期保存が目的の場合は、別途画像をダウンロードしてパスを書き換える処理が必要です。
はてな記法で書かれた本文は変換できません。Markdownの記事は --markdown で変換できます。