Go を書けば、PDF ができる。

gpdf は標準ライブラリだけで動く Go の PDF ライブラリです。12 カラムのグリッドでページを組み、日本語・中国語・韓国語のフォントを埋め込み、1 ページを約 13 µs で描画します。

$go get github.com/gpdf-dev/gpdf
しくみ
invoice.go
doc := template.New(template.WithPageSize(document.A4))
page := doc.AddPage()

page.AutoRow(func(r *template.RowBuilder) {
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("ACME Corporation", template.FontSize(24),
            template.Bold(), template.TextColor(navy))
    })
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("INVOICE", template.FontSize(28),
            template.Bold(), template.AlignRight())
    })
})

page.AutoRow(func(r *template.RowBuilder) {
    r.Col(12, func(c *template.ColBuilder) {
        c.Table(header, items,
            template.ColumnWidths(40, 15, 20, 25),
            template.TableStripe(pdf.RGBHex(0xF5F5F5)),
        )
    })
})

data, err := doc.Generate()
invoice.pdfPDF を開く
gpdf で生成した請求書 PDF:会社名のヘッダー、請求先、縞模様の明細表、合計

純 Go、それだけ。

go.mod にあるのは Go 本体だけ。cgo もヘッドレスブラウザも、サービスの横に置くネイティブバイナリもいりません。

見慣れたレイアウト。

行と 12 カラムのグリッドがページに流れ込みます。表はページをまたいで分かれ、文字は自動で折り返します。

どの文字も埋め込む。

TrueType フォントは使った字形だけをサブセット化。日本語・中国語・韓国語がどのサーバーでも同じ見た目になります。

ベンチマーク

リクエストの中で生成できる速さ。

同じ 4 つの文書を gpdf・go-pdf/fpdf・signintech/gopdf・maroto v2 で作りました。1 文書あたりの時間とメモリ。小さいほど良い値です。

1 ページ
見出しと段落のある A4 1 ページ
gpdf
x
13 µs
fpdf
x
132 µs
gopdf
x
423 µs
maroto v2
x
237 µs
10〜33 倍速い時間
表(4×10)
ヘッダー行つきのスタイル付き表
gpdf
x
108 µs
fpdf
x
241 µs
gopdf
x
835 µs
maroto v2
x
8,600 µs
2〜80 倍速い時間
100 ページ
同じページを 100 回くり返す
gpdf
x
683 µs
fpdf
x
11,700 µs
gopdf
x
8,600 µs
maroto v2
x
19,800 µs
13〜29 倍速い時間
複合文書
見出し・表・文章が混ざった文書
gpdf
x
133 µs
fpdf
x
254 µs
gopdf
x
997 µs
maroto v2
x
10,400 µs
2〜78 倍速い時間
1 ページのメモリ
1 ページを組む間に確保した量
gpdf
x
16 KB
fpdf
x
1,200 KB
gopdf
x
1,800 KB
maroto v2
x
61 KB
メモリ 4〜113 分の 1メモリ
100 ページのメモリ
100 ページを組む間に確保した量
gpdf
x
909 KB
fpdf
x
121,000 KB
gopdf
x
83,000 KB
maroto v2
x
4,000 KB
メモリ 4〜133 分の 1メモリ

5 回の中央値、各 100 回の反復。Apple M1、Go 1.25。ベンチマークのコードは gpdf のリポジトリにあります。

ベンチマークのコードを見る

Go ネイティブの設計

Go で作った。ほかに動かすものはない。

Go で PDF を作る多くの構成は、言語の外に頼ります。サイドカーのヘッドレスブラウザ、HTTP 越しの HTML→PDF サービス、ネイティブライブラリへのバインディング。どれもデプロイし、パッチを当て、監視するランタイムが 1 つ増えます。

gpdf は最初の 1 行から Go で書かれています。あなたのバイナリに組み込まれ、Go が動く場所ならどこでも動き、依存ツリーは標準ライブラリだけ。セキュリティチームが追加で監査するものはありません。

go get を 1 回、バイナリは 1 つ。開発でも本番でも同じ出力です。

よくある構成

あなたの Go アプリ

HTTP 呼び出し / cgo バインディング

ヘッドレスブラウザ · JVM · ネイティブライブラリ

デプロイし、パッチを当て、監視するランタイムがまた 1 つ。

gpdf

あなたの Go アプリ

go get

github.com/gpdf-dev/gpdf

バイナリ 1 つ · 標準ライブラリのみ · cgo なし

動く環境

LinuxmacOSWindowsDockerServerless

CJK を最優先に

日本語・中国語・韓国語を、書いたとおりに。

多くの PDF ライブラリは CJK を後回しにします。gpdf は最初から CJK を前提に作られています。

  • どの TrueType フォントも埋め込めます。ファイルに書くのは使った字形だけです。

  • 日本語・中国語・韓国語・欧文を 1 つの段落や表に混ぜられます。

  • 豆腐(□)も文字化けもなし。サーバーに入っているフォントに左右されません。

フォントのガイドを読む
Noto Sans JP のサブセットを埋め込んで gpdf で描いた日本語日本語・中国語・韓国語が混ざった gpdf の表

日本語 · 中文 · 한국어

レイアウトの先まで。

長期保存、セキュリティ、後処理も同じモジュールに入っています。それでも依存は Go の標準ライブラリだけです。

PDF/A

XMP メタデータつきの PDF/A-1b・PDF/A-2b。何十年も読める必要がある文書に。

AES-256 暗号化

所有者・利用者のパスワードと、印刷・コピー・編集の権限設定。

電子署名

RFC 3161 タイムスタンプつきの PKCS#7 署名を、できあがった PDF に付けます。

ヘッダーとフッター

全ページにくり返すヘッダー・フッターとページ番号。

QR コードとバーコード

QR と Code 128 をそのまま生成。PNG・JPEG の画像と並べられます。

結合と分割

Go の中で PDF を結合し、ページ範囲を取り出せます。

ほかにも…

既存の PDF へのオーバーレイ、入力済み AcroForm のフラット化。

サンプルを見る

gpdf とほかの選択肢

PDF ライブラリ選びは機能だけでは決まらない。

何をデプロイし、何にお金を払い、何にパッチを当て続けるのか。

gpdf商用 Go SDKHTML→PDF(ヘッドレスブラウザ)
ライセンスMIT、商用でも無料有料ライセンスか従量キーOSS だがブラウザは自分で運用
依存Go 標準ライブラリのみベンダーのモジュール全イメージにブラウザ
デプロイGo バイナリの中Go バイナリ+ライセンスキーサイドカーか別サービス
CJK標準対応、サブセット埋め込みフォント設定しだいイメージ内のフォントしだい
1 ページ約 13 µs製品によるリクエストごとにブラウザ描画

go get から本番まで。

スタックに合う入口を選んでください。3 つとも同じ描画エンジンを通ります。

1 行でインストール

go get github.com/gpdf-dev/gpdf。Go 1.22 以降で動きます。

Builder API

型安全な流れるような Go:PageBuilder → RowBuilder → ColBuilder。

JSON スキーマ

文書を JSON で書き、どのサービス・言語からでも送れます。

Go テンプレート

text/template で JSON スキーマを動かし、1 つの元から何千もの文書を。

すぐ使えるテンプレート

請求書・領収書・見積書をコピーして手直しできます。

動くサンプル

どのサンプルも本物の PDF を描くテスト。表から署名まで。

ゴールデンファイルのテスト

リリースのたびに、どのサンプルも保存した PDF とバイト単位で比べます。

規格への適合を確認

生成したファイルを CI で PDF の仕様に照らして検証します。

Go 1.22〜1.26

対応するすべての Go のバージョンで、レース検出つきで全テストを流します。

FAQ

使う前のよくある質問

gpdf は外部依存ゼロの純 Go で書かれた、MIT ライセンスの PDF 生成ライブラリです。12 カラムのグリッドでページを組み、日本語・中国語・韓国語を含む TrueType フォントを埋め込みます。

最初の PDF を今日出そう。

go get を 1 回、あとは Go を数行。