> ## Documentation Index > Fetch the complete documentation index at: https://pdfbase.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # CLI Commands > Full reference for every CLI command. ## pdfbase create Generate a PDF from HTML, a file, or a URL. ```bash theme={null} pdfbase create [options] ``` | Option | Description | | ----------------------- | ----------------------------------------------- | | `--html ` | HTML string to render | | `--from ` | Source type: `html`, `url` | | `--input ` | File path or URL (used with `--from`) | | `-o, --output ` | Output file path (default: stdout) | | `--format ` | Page format: a4, letter, legal, etc. | | `--margin ` | Margins: `"20mm"` or `"top,right,bottom,left"` | | `--landscape` | Landscape orientation | | `--compress ` | Compression: none, low, medium, high | | `--wait-until ` | Load event: domcontentloaded, load, networkidle | | `--wait-for ` | CSS selector to wait for | | `--timeout ` | Render timeout in milliseconds | | `--debug` | Include debug output | | `--header ` | Header HTML | | `--footer ` | Footer HTML | ### Examples ```bash theme={null} # Minimal pdfbase create --html "

Hello

" -o hello.pdf # From file with options pdfbase create --from html --input report.html -o report.pdf \ --format letter --margin "25mm" --compress medium # From URL with wait pdfbase create --from url --input "https://app.com/report" \ --wait-for "#ready" --timeout 60000 -o report.pdf # Debug mode — saves debug info alongside PDF pdfbase create --html "..." --debug -o output.pdf # Creates: output.pdf, output.debug.json, output.screenshot.png ``` *** ## pdfbase render Render a stored template with data. ```bash theme={null} pdfbase render [options] ``` | Option | Description | | --------------------- | --------------------------------------- | | `--data ` | JSON string of template data | | `--data-file ` | Path to a JSON file with template data | | `-o, --output ` | Output file path | | `--format ` | Override template's default format | | `--compress ` | Override template's default compression | ### Examples ```bash theme={null} # Inline data pdfbase render invoice --data '{"number":"INV-001","customer":"Acme","total":"$500"}' -o inv.pdf # From file pdfbase render invoice --data-file ./invoices/acme.json -o inv.pdf ``` *** ## pdfbase templates Manage templates via templates-as-code. ### pdfbase templates push Push local templates to PDFBase. Reads from `pdfbase.json`. ```bash theme={null} pdfbase templates push [--dry-run] ``` `--dry-run` shows what would change without making changes. ### pdfbase templates pull Pull remote templates to local files. ```bash theme={null} pdfbase templates pull [--all | --name ] ``` ### pdfbase templates preview Render a template locally and open in your browser. ```bash theme={null} pdfbase templates preview [--data-file ] [--data ] ``` ### pdfbase templates diff Show differences between local and remote templates. ```bash theme={null} pdfbase templates diff [--name ] ``` ### pdfbase templates list List all remote templates. ```bash theme={null} pdfbase templates list [--json] ``` *** ## pdfbase webhooks Test and manage webhook endpoints. ### pdfbase webhooks test Send a test event to a webhook endpoint. ```bash theme={null} pdfbase webhooks test --event ``` ### pdfbase webhooks list List all webhook endpoints. ```bash theme={null} pdfbase webhooks list [--json] ``` *** ## pdfbase merge Merge multiple PDFs into one. (Phase 2) ```bash theme={null} pdfbase merge [file3...] -o merged.pdf ``` | Option | Description | | --------------------- | ----------------------------------------------------------------------- | | `-o, --output ` | Output file path | | `--compress ` | Compression level for output | | `--pages ` | Per-file page ranges, comma-separated: `"1-3,,4-6"` (empty = all pages) | *** ## pdfbase split Split a PDF into separate files. (Phase 2) ```bash theme={null} pdfbase split --ranges "1-5" "6-10" -o output-dir/ ``` | Option | Description | | ---------------------- | ----------------------------------------- | | `--ranges ` | Page ranges, each becomes a separate file | | `-o, --output ` | Output directory | *** ## pdfbase watermark Add a watermark to a PDF. (Phase 2) ```bash theme={null} pdfbase watermark --text "DRAFT" -o watermarked.pdf ``` | Option | Description | | ---------------------- | ------------------------------------------------------ | | `--text ` | Watermark text | | `--color ` | Color with alpha (default: "#00000020") | | `--rotation ` | Rotation (default: -45) | | `--position ` | center, top-left, top-right, bottom-left, bottom-right | | `-o, --output ` | Output file path | *** ## pdfbase extract Extract content from a PDF. (Phase 3) ```bash theme={null} pdfbase extract text [--format text|markdown|structured] pdfbase extract ocr [--language eng] pdfbase extract tables [--format json|csv] pdfbase extract structured --preset invoice ``` | Option | Description | | ------------------- | -------------------------------------------------------- | | `--format ` | Output format | | `--language ` | OCR language code | | `--preset ` | AI extraction preset: invoice, receipt, contract, resume | | `--schema ` | Custom extraction schema (JSON string) | | `--pages ` | Pages to extract from | *** ## pdfbase convert Convert between formats. (Phase 2) ```bash theme={null} pdfbase convert office -o output.pdf pdfbase convert thumbnail [--page 1] -o thumb.png ``` | Option | Description | | --------------------- | -------------------------------------- | | `--page ` | Page number for thumbnail (default: 1) | | `--landscape` | Force landscape for office conversion | | `-o, --output ` | Output file path | *** ## pdfbase batch Create and manage batch jobs. (Phase 1) ```bash theme={null} # Create a batch from a JSON file pdfbase batch create --items batch-items.json # Check batch status pdfbase batch status # Download all results pdfbase batch download -o output-dir/ ``` | Option | Description | | --------------------- | -------------------------------- | | `--items ` | JSON file with batch items array | | `--parallel ` | Concurrent renders (default: 5) | | `--output ` | individual, merged, or zip | | `-o, --output ` | Output path for downloads | *** ## pdfbase requests Manage and replay API requests. ```bash theme={null} # List recent requests pdfbase requests list [--limit 10] [--status completed|failed] # Replay a request with debug enabled pdfbase requests replay ``` *** ## pdfbase auth Manage authentication. ```bash theme={null} pdfbase auth login # Interactive login pdfbase auth logout # Remove stored credentials pdfbase auth status # Show current auth state ``` *** ## pdfbase status Check PDFBase API status and your account usage. ```bash theme={null} pdfbase status ``` Output: ``` API: ✓ healthy (23ms) Account: your-email@example.com Plan: Pro ($99/mo) Usage: 1,247 / 10,000 credits this month Rate limit: 300 req/min (using 0) ```