【ITニュース解説】Ask HN: What is nowadays (opensource) way of converting HTML to PDF?

「HTMLからPDFへの変換」は、システム開発の現場で頻繁に必要となる処理だ。例えば、Webサイトの情報を元に請求書やレポート、契約書などの帳票を作成したり、ユーザーが閲覧しているWebページの内容を印刷用に整形してPDFとしてダウンロードできるようにしたりといった場面で用いられる。この変換処理は一見単純そうに見えるが、Webページの多様なレイアウトやJavaScriptによる動的な内容、複雑なCSSを正確にPDFに再現するのは容易ではない。

かつて、この分野で広く利用されていたオープンソースツールに「wkhtmltopdf」があった。これは、Webkitというレンダリングエンジン（かつてSafariブラウザなどで使われていた技術）をベースにしており、HTMLとCSSからPDFを生成するツールとして人気を博した。しかし、Webkitのバージョンが古く、最新のHTMLやCSSの仕様、特にCSS FlexboxやCSS Gridといったモダンなレイアウト技術や、JavaScriptによって動的に生成されるコンテンツへの対応が不十分だという課題が指摘されていた。また、プロジェクト自体の更新も停滞気味であり、現代の複雑なWebページを正確にPDF化するには限界が見えてきていたのだ。

現代において、最も強力で推奨される方法の一つが「Headless Chrome」を利用するアプローチだ。「Headless」とは「画面表示なし」という意味で、Google ChromeブラウザをGUI（グラフィカルユーザーインターフェース）なしで、つまりバックグラウンドで動作させることを指す。このHeadless Chromeを使うことで、実際のChromeブラウザがWebページをレンダリングするのと全く同じ仕組みでPDFを生成できる。そのため、最新のHTML5、CSS3、そしてJavaScriptによる動的なコンテンツ、ウェブフォント、SVGグラフィックなど、あらゆる現代的なWeb技術をほぼ完璧にPDFに変換することが可能になる。 このHeadless Chromeをプログラムから操作するためのライブラリがいくつか存在し、JavaScriptで書かれた「Puppeteer」や「Playwright」がその代表例だ。これらのライブラリを使えば、まるで人がブラウザを操作するように、ページにアクセスし、特定の要素をクリックしたり、フォームに文字を入力したり、そして最終的にそのページのスクリーンショットを撮ったり、PDFとして保存したりといった一連の操作を自動化できる。これにより、Webサイトの複雑なデザインやインタラクティブな要素も正確にPDFに反映できるようになった。ただし、Headless Chromeは実際のブラウザを起動するため、それなりのメモリやCPUリソースを消費するという点は考慮する必要がある。

別の優れた選択肢として、Python製の「WeasyPrint」がある。これはWeb標準を策定する団体であるW3CのHTMLとCSSの標準仕様に非常に忠実に従うことを目指して開発されているツールだ。特に、印刷用のCSS（CSS Paged Media）の仕様への対応が進んでいる点が大きな特徴である。Webページをブラウザで表示する際と、それを印刷する際では、レイアウトに対する考え方が異なることがある。例えば、ページ番号の配置、各ページの余白、ヘッダーやフッターの表示、特定の要素を新しいページの先頭から始める「改ページ」の指定などだ。WeasyPrintは、これらの印刷特有の要件をCSSで細かく制御できるため、高品質な帳票やドキュメントを生成するのに適している。サーバーサイドのアプリケーションでPythonを利用している場合に、特にスムーズに導入できるだろう。

複数の種類のファイルをPDFに変換する機能を集約し、APIとして提供する「Gotenberg」も注目されている。これはGo言語で書かれており、Dockerコンテナとして簡単にデプロイできるのが特徴だ。Dockerコンテナは、ソフトウェアとその実行に必要なものを一つにまとめた軽量な仮想環境のようなもので、どんな環境でも同じように動かせる。Gotenbergは内部でHeadless Chrome（Chromium）やLibreOfficeなどのさまざまな変換エンジンを利用し、HTML、Markdown、Officeファイル（Word, Excel, PowerPointなど）といった多様な形式のドキュメントを統一されたAPIインターフェースを通じてPDFに変換できる。開発者は個々の変換エンジンの詳細を知る必要がなく、GotenbergのAPIを呼び出すだけで済むため、複雑な環境構築の手間を省き、迅速にPDF変換サービスを構築したい場合に非常に便利だ。

また、ブラウザの内部でPDF生成を行うためのJavaScriptライブラリ「paged.js」というアプローチもある。これは、Webブラウザのレンダリング能力を直接利用し、HTMLとCSS Paged Mediaの仕様に基づいて、クライアントサイド（ユーザーのブラウザ）でPDFを生成する。この方法の利点は、サーバーに負荷をかけずにPDFを生成できる点と、ユーザーがブラウザ上で見ているプレビューと、生成されるPDFがほとんど同じ見た目になることが保証されやすい点にある。Webベースのドキュメントエディタや、電子書籍のように複雑なページ構成を持つコンテンツの表示・出力に適している。

どのツールを選択するにしても、高品質なPDFを生成するためには、「Print CSS（印刷用CSS）」の適切な記述が非常に重要だ。これはWebブラウザで表示される画面用CSSとは別に、印刷時に適用されるCSSルールを定義するものだ。例えば、@media printルールを使って印刷時のみに適用されるスタイルを指定したり、@pageルールでページのサイズ、余白、ヘッダー・フッターの内容を制御したり、page-break-beforeやpage-break-afterといったプロパティで強制的に改ページを挿入したりすることで、PDFの体裁を整えることができる。これらのCSSテクニックを使いこなすことで、Webページの内容を、より紙媒体に適した形式でPDFとして出力することが可能となる。

まとめると、HTMLからPDFへの変換技術は日々進化しており、単にWebページを画像として保存するだけでなく、複雑なレイアウトや動的なコンテンツを正確に再現し、印刷に適したドキュメントを生成するための様々なツールとアプローチが提供されている。目的や開発環境、求められるPDFの品質に応じて、Headless Chrome/Puppeteer、WeasyPrint、Gotenberg、paged.jsといったツールの中から最適なものを選択し、さらにPrint CSSの知識を組み合わせることで、高品質なPDF変換を実現できるだろう。どのツールも一長一短があるため、それぞれの特徴を理解し、自分のプロジェクトに合ったものを見つけることがシステムエンジニアにとって大切な課題となる。