COMMAND LINE

Marqius CLI

HTML in. Print PDF out.

Render and check PDFs locally with marqius-wkhtmltopdf. Keep the wkhtmltopdf commands your app already uses.

Install the CLI
Invoice 1001 rendered by Marqius, with three line items and a total of 120.00 EUR
Terminalv0.12.8

marqius-wkhtmltopdf --page-size A4 invoice.html invoice.pdf

pdfinfo invoice.pdf | grep '^Pages:'

Pages: 1

Open the generated invoice

Install the CLI

For Apple silicon Macs and x86-64 or ARM64 Linux. Install in your user folder and make the CLI available in this shell.

Shell install command
curl -fsSLo marqius-install.sh https://marqius.com/marqius-wkhtmltopdf.sh &&
  sh marqius-install.sh --version 0.12.8 --prefix "$HOME/.local/bin" --no-wkhtmltopdf &&
  export PATH="$HOME/.local/bin:$PATH" &&
  marqius-wkhtmltopdf --version

Teach your coding agent

Give your agent the commands and checks it needs to work with Marqius.

marqius-pdf

Render & check PDFs

Make a PDF from local HTML and check the result. Includes the sample invoice.

marqius-migrate

Migrate from wkhtmltopdf

Find your library’s executable setting and compare PDFs before switching.

Set up your agent

In your project, extract the two skill folders into .agents/skills/. Open a new Codex session in that project and try this prompt.

Codex prompt
$marqius-pdf Render the bundled sample invoice and check its page count and total.
Codex skill documentation

Make your first PDF.

With Docker running, copy these commands into a shell. Open invoice.pdf and look for one A4 page, Invoice 1001 and a total of 120.00 EUR.

See the expected PDF
Docker sample commands
mkdir -p marqius-cli-demo
cd marqius-cli-demo
curl -fsSLo invoice.html https://marqius.com/download/wkhtmltopdf-demo/0.12.8/invoice.html.txt &&
  docker run --rm --network none --mount "type=bind,source=$PWD,target=/data" \
    marqius/wkhtmltopdf:0.12.8 --page-size A4 invoice.html invoice.pdf

Render local HTML

Generate a PDF using the page size your document needs.

Render local HTML command
marqius-wkhtmltopdf --page-size A4 invoice.html invoice.pdf

Compare two PDFs

Check the output from your current setup against the candidate PDF.

Compare two PDFs command
marqius-wkhtmltopdf compare original.pdf candidate.pdf

Find supported flags

Consult the flags for your installed release.

Find supported flags command
marqius-wkhtmltopdf -H
QUESTIONS & ANSWERS

Questions about Marqius CLI

What do I install to use Marqius CLI?

Use the public marqius-wkhtmltopdf executable on a supported platform or the versioned Docker image. Both accept wkhtmltopdf-style commands for rendering HTML as PDF.

Can I use the skills with my coding agent?

Yes. The download contains two portable SKILL.md folders. The page shows the workspace locations for Codex, Claude Code, OpenCode, Antigravity, Gemini CLI, and GitHub Copilot CLI.

Do I need an account to generate the sample PDF?

The Docker example renders the bundled invoice locally without a Marqius account. Review the licence and trial options before using the converter in production.

What is the difference between the two skills?

Use marqius-pdf to render and inspect a PDF. Use marqius-migrate to find the executable setting in an existing integration, test a candidate and keep a rollback path.

Will my application work with the CLI?

The public edition is designed for libraries that launch wkhtmltopdf as an executable. Apps that load libwkhtmltox directly require a separate integration. Compare representative PDFs before switching.