---
title: エクスポート
description: >-
  任意のページを PDF または EPUB として読者にダウンロードしてもらえます。クライアントサイドでレンダリングされるため、静的ビルドは静的なままで、サーバーインフラは不要です。
---

Blume は目次の下にある[ページアクション](/ja/docs/content/navigation#page-actions)に **エクスポート** アクションを追加でき、読者が閲覧中のページを **PDF** または **EPUB** として保存できるようになります。デフォルトでは無効で、完全にクライアントサイドで動作します。サーバーは不要で、[静的](/ja/docs/deployment)ビルドは静的なままです。

## 有効化する [#enable-it]

ひとつのトグルで両方の形式を有効にできます。

```ts blume.config.ts
export: true,
```

片方の形式だけを提供したい場合は、代わりにオブジェクトを渡します。

```ts blume.config.ts
export: {
  pdf: true,
  epub: false,
},
```

省略した形式（または `false` に設定した形式）はメニューから除外されます。両方を無効にした場合（デフォルト）、**エクスポート** アクション自体が表示されません。

## PDF

**PDF にエクスポート** は、ヘッダー・サイドバー・ナビゲーション、記事より後ろにあるすべての要素（最終更新日、フィードバック、前後のページへのリンク、サイトのフッター）、さらにコードブロックのコピーボタンといったサイトのクロームを取り除いて記事本文だけにする印刷用スタイルシートを適用した状態で、ブラウザの印刷ダイアログを開きます。折りたたまれた [`expandable`](/ja/docs/content/syntax#long-lines-and-long-blocks) コードブロックは全体が印刷され、ダークテーマで閲覧しているページはライトテーマで印刷されます。**PDF として保存** を選ぶと完了です。読者がブラウザ自体のメニューから印刷した場合にも、同じスタイルシートが適用されます。

実際にスタイルが適用されたライブページを印刷するため、結果として鮮明で選択可能なテキスト、本物のフォント、シンタックスハイライトされたコードがそのまま保たれます。依存関係は不要で、開発環境でも本番環境でも静的ホスティングでも同じように動作します。

:::note
PDF エクスポートはブラウザのネイティブな印刷ダイアログを経由するため、「PDF として保存」の正確な文言やオプションはブラウザによって異なります。コードブロックやコールアウトの背景を保持するには、ダイアログで **背景のグラフィック** を有効にしてください。
:::

## EPUB

**EPUB にエクスポート** は、現在のページの自己完結型 `.epub` をブラウザ内で生成してダウンロードします。Apple Books、Calibre、その他あらゆる電子書籍リーダーですぐに読めます。ジェネレーターは読者がエクスポートをクリックしたときにのみ読み込まれるため、サイトの他の部分に負荷をかけることはありません。

スタイルシートや JavaScript を持たないデバイス上でも読みやすいファイルにするため、Blume はページをクリーンで独立した HTML に書き換えます。シンタックスハイライトされたコードはプレーンな等幅テキストになり、装飾用のアイコンやコピーボタンは削除され、組み込みの電子書籍リーダー用スタイルシートが余白・コードブロック・テーブルを処理します。書籍にはこのページしか含まれないため、他のページへのリンクは公開中のサイトを指します。

書籍のタイトルにはページの見出しが使われ、言語はページの言語を引き継ぎ、著者と発行者にはサイトの [`title`](/ja/docs/configuration#site) が設定されます。画像は取得されて書籍に埋め込まれます。クロスオリジンリクエストを許可していない別ホスト上の画像など、ブラウザが取得できない画像は除外され、ブラウザのコンソールに警告が表示されます。

## エクスポートされる範囲 [#what-gets-exported]

どちらの形式も、読者が閲覧している **単一のページ** をエクスポートします。サイト全体ではありません。これは、アクションが配置されている場所、つまりそのページの目次の下という位置づけと一致しています。他の[ページアクション](/ja/docs/content/navigation#page-actions)と同様に、幅 1,280px 以上のウィンドウでは右側のカラムに、それより狭いウィンドウやスマートフォンではコンテンツ上部の「このページの内容」ドロップダウンに配置されます。

:::note
EPUB にはタブを切り替えるための JavaScript がないため、[package-install](/ja/docs/content/syntax) ブロックやコードグループなどのタブ付きコンテンツは、すべてのパネルが同時に表示されるように展開されます。Mermaid ダイアグラムのようなクライアントサイドでレンダリングされる埋め込みは含まれません。
:::