pdf-oxide CLI — ターミナルの最速 PDF ツール

pdf-oxide はローカル PDF 処理のためのコマンドラインツールです。ライブラリと同じ Rust コアを利用し、クラウドやシステム依存は不要。text・markdown から compress・encrypt・watermark まで 23 のコマンドを提供します。

クイックインストール（推奨）

1 つのコマンドで OS とアーキテクチャを自動的に判別します。

Linux / macOS

curl -fsSL oxide.fyi/install.sh | sh

Windows (PowerShell)

irm oxide.fyi/install.ps1 | iex

その他のインストール方法

Homebrew (macOS / Linux)

brew install yfedoseev/tap/pdf-oxide

Cargo

cargo install pdf_oxide_cli

cargo-binstall（ビルド済みバイナリ）

cargo binstall pdf_oxide_cli

ビルド済みバイナリ

GitHub Releases からダウンロードし、PATH の通ったディレクトリに配置してください。

クイックスタート

# テキストを抽出
pdf-oxide text document.pdf

# Markdown に変換
pdf-oxide markdown document.pdf -o output.md

# HTML に変換
pdf-oxide html document.pdf -o output.html

# PDF 情報を表示（ページ数・メタデータ・暗号化）
pdf-oxide info document.pdf

# テキストを検索（正規表現対応）
pdf-oxide search document.pdf "pattern"

コマンド一覧

コマンド	説明	主なフラグ
text	プレーンテキストを抽出	--format plain|words|lines、--area x,y,w,h
paths	ベクターパスを抽出	--format json|rects|lines、--area x,y,w,h
markdown	Markdown に変換	—
html	HTML に変換	—
info	メタデータとページ数を表示	—
search	テキストを検索（正規表現）	-i（大文字小文字無視）、--pages
images	画像を抽出	--area x,y,w,h、--pages
render	ページを PNG/JPEG としてレンダリング	--dpi N、--format png|jpeg、--quality N
merge	複数の PDF を結合	（2 ファイル以上必要）
split	1 ページずつに分割	—
create	Markdown/HTML/テキストから PDF を作成	--from markdown|html|text
compress	圧縮・最適化	—
encrypt	パスワードで暗号化（v0.4.0 で実装予定。現状はプレースホルダ）	—
decrypt	保護された PDF を復号	--password PW
rotate	ページを回転	--degrees 90|180|270|-90
delete	ページを削除	--pages
reorder	ページを並べ替え	--order "3,1,2,5,4"
metadata	メタデータを読み取り・編集・削除	--title、--author、--subject、--keywords、--strip
watermark	テキスト透かしを追加	--opacity 0.3、--rotation 45、--font-size 48、--color R,G,B
bookmarks	目次（アウトライン）を一覧表示	—
flatten	注釈やフォームをフラット化	--forms、--annotations
crop	ページ余白をトリミング	--margins L,R,T,B
forms	フォームフィールドを一覧・入力・エクスポート	--fill "k=v,…"、--export fdf|xfdf、--area x,y,w,h

合計 23 コマンド。各コマンドの全フラグは pdf-oxide <command> --help で確認できます。

グローバルオプション

-o, --output <PATH>        出力ファイル（テキスト出力時は既定で stdout）
-p, --pages <RANGE>        ページ範囲："1-5"、"1,3,7"、"1-3,7,10-12"
    --password <PW>        暗号化された PDF のパスワード
-v, --verbose              処理時間を表示
-q, --quiet                不要な出力を抑制
-j, --json                 JSON で出力
    --no-banner            REPL バナーをスキップ

使用例

1〜5 ページ目を Markdown として抽出:

pdf-oxide markdown report.pdf --pages 1-5 -o report.md

3 つの PDF を結合:

pdf-oxide merge cover.pdf body.pdf appendix.pdf -o combined.pdf

透かしを追加:

pdf-oxide watermark contract.pdf "DRAFT" --opacity 0.2 --font-size 72

フォームフィールドを入力:

pdf-oxide forms application.pdf --fill "name=Jane Doe,date=2026-02-28" -o filled.pdf

大文字小文字を区別しない正規表現で検索:

pdf-oxide search paper.pdf "neural.?network" -i

1 ページ目を 300 DPI の PNG としてレンダリング:

pdf-oxide render report.pdf --dpi 300 --format png --pages 1 -o page1.png

回路図のベクターパスを JSON として抽出:

pdf-oxide paths schematic.pdf --format json -o paths.json

インタラクティブ REPL

引数なしで pdf-oxide を実行するとインタラクティブモードに入ります。

$ pdf-oxide
pdf-oxide> text /path/to/doc.pdf
（抽出されたテキストが表示されます）
pdf-oxide> info /path/to/doc.pdf
（メタデータが表示されます）