# Marqius website knowledge Public page content with canonical sources. --- Source: https://marqius.com/ Markdown: https://marqius.com/aeo/okf/products-and-guides/home.md HIGH-VOLUME PRINT AUTOMATION # The next run can’t wait. Turn fresh data into the next batch of statements, letters or catalogues. Keep your approved layout and check the proof before it goes to press. [Discuss Your Print Run](https://marqius.com/contact)[See How It Works](https://marqius.com/#production-speed) ILLUSTRATIVE CONCEPT BUILT FOR DAILY VOLUME ## Production speed. Print fidelity. **8×**Speed [**Keep the batch moving.** Run independent jobs in parallel and reuse the files that haven’t changed.](https://marqius.com/features/parallel-batch-processing/) **High Fidelity** [**Keep detail on the page.** Set colour, bleed and trim for your press, then check the PDF before release.](https://marqius.com/features/prepress-and-imposition/) THE WORK BEHIND THE DOCUMENT ## From source content to the final proof. Bring reviewed content into the same production process: generate the batch, set it up for print and check the result before release. [All features](https://marqius.com/features/) AI & INTEGRATION ### Generate PDFs from AI workflows Give an MCP-compatible assistant a tool that turns HTML or Markdown into a laid-out PDF. Use Marqius for rendering and keep the source content and review in your workflow. [Explore feature](https://marqius.com/features/ai-pdf-generation/) PRODUCTION SPEED ### Run batches in parallel Keep deadline-driven runs moving: render independent jobs in parallel and reuse cached output when inputs haven’t changed. [Explore feature](https://marqius.com/features/parallel-batch-processing/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) USPS & TRANSACTIONAL PRINT ## USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. [Explore USPS Intelligent Mail](https://marqius.com/features/usps-intelligent-mail/) ALREADY USING WKHTMLTOPDF? ## Keep your code. _Check the PDF._ A drop-in replacement for wkhtmltopdf in 14 PDF libraries. Keep your code and templates, then compare a familiar document before switching production. [Drop-in replacement for wkhtmltopdf](https://marqius.com/wkhtmltopdf/) [Install and check](https://marqius.com/wkhtmltopdf/download/) START WITH THE DOCUMENT ## What do you need to produce? Choose a document your team already makes. See what goes into a first proof and which Marqius tools fit the job. [All use cases](https://marqius.com/use-cases/) [ ### Catalogues and price lists Use product records, photography and ranked specifications to build a consistent edition without redesigning every page. Explore workflow ](https://marqius.com/use-cases/catalogues/)[ ### Personalised PDF batches Turn structured records into consistent PDFs without manually replacing the names, values or details in each copy. Explore workflow ](https://marqius.com/use-cases/batch-pdfs/)[ ### Book interiors and covers Build a publication around its reading rhythm, from chapter openers and typography to illustrations, notes and the cover. Explore workflow ](https://marqius.com/use-cases/books/) Illustrative concept · One layout, multiple versions WHY MARQIUS ## Approve the layout. Repeat the run. Marqius fits when your print queue fills with the same kinds of documents and the details change each time. Your team can keep the decisions it has already approved and spend its time checking the records, the exceptions and the final proof. - **Keep the design your team approved.** - **Plan for the records that don’t fit neatly.** - **Prepare for the way you actually print.** [See why Marqius fits recurring work](https://marqius.com/why-marqius/) FIND YOUR STARTING POINT ## Choose the tool for the work you do. [ Marqius Engine ### Generate finished PDFs. Turn HTML, Markdown and source data into PDFs with the press settings and checks your production needs. Explore Engine ](https://marqius.com/engine/)[ Marqius Relay ### Keep the next run moving. Bring changing information, approved layouts, job tracking and delivery into one recurring document workflow. Explore Relay ](https://marqius.com/relay/)[ Marqius Studio ### Prepare your next book. Choose a book design and trim size, review the interior, and prepare the cover and edition files. Explore Studio ](https://marqius.com/studio/)[ Marqius wkhtmltopdf ### Drop-in replacement. Keep your code across 14 PDF libraries. Reuse your templates, render a familiar document and compare the PDF before switching. Explore wkhtmltopdf ](https://marqius.com/wkhtmltopdf/) BUILT AROUND YOUR WORK ## Find your industry. See how the same production approach applies to different documents, review steps and print requirements. [All industries](https://marqius.com/industries/) [Financial services & insurance](https://marqius.com/industries/financial-services/)[Healthcare administration](https://marqius.com/industries/healthcare/)[Manufacturing & distribution](https://marqius.com/industries/manufacturing-and-distribution/)[Retail](https://marqius.com/industries/retail/)[Logistics & operations](https://marqius.com/industries/logistics/)[Publishing & education](https://marqius.com/industries/publishing-and-education/) A PRACTICAL EVALUATION ## Bring your hardest example. A simple sample can hide the problems that recur in production. Start with an anonymised document that puts real pressure on the layout. 1. **Pick one document you produce regularly.** Note how often it runs, where the data comes from and what people still do by hand. 2. **Try two contrasting records.** Include a typical one and one with longer text, more rows or missing fields. 3. **Agree on what the proof must pass.** Check that the content is right, the pages break where they should, and your print partner can use the PDF. ## Start with the document your team makes every week. Bring an anonymised example and tell us what changes each time. We’ll discuss what the proof needs to show. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Getting started with Marqius ### What does Marqius do? Marqius helps you turn structured information into professionally laid-out PDFs. It brings together reusable designs, personalised records and controls for preparing pages for print. ### Which product should I start with? Start with Relay if the challenge is a recurring workflow from data through delivery. Use Engine to generate PDFs from an existing system, and Engine’s publishing workflow to lay out books and publications. ### Do I need to rebuild my document to explore Marqius? Start with an existing anonymised PDF and a few fictional records that show how the content varies. That gives us something concrete to review together. ### Is Marqius a printing service? Marqius prepares document files. Your production team or print partner handles the physical run and confirms the final file requirements. --- Source: https://marqius.com/accessibility/ Markdown: https://marqius.com/aeo/okf/policies/accessibility.md SIMPLE AI LLC · MARQIUS # Website Accessibility We want people to be able to read about Marqius, compare products and contact us using the tools they prefer. Updated 18 November 2026 ## Features on this website The site includes a skip link, keyboard focus indicators, labelled form controls, text alternatives for informative imagery and layouts that adapt to narrow screens. Motion is reduced when your device requests reduced motion. ## Report a problem If you have trouble accessing a page, using a control or reading an example, please tell us the page address, what you were trying to do and what happened. You can also request information in another format. You do not need to include private information about your disability or device. Simple AI LLC 1209 Mountain Road Pl NE, Ste N Albuquerque, NM 87110 United States [Telegram: +1 505 305 1025](https://t.me/+15053051025) QUESTIONS & ANSWERS ## Accessibility questions ### How do I report an accessibility problem? Send the page address, the task you were trying to do and a brief description of what happened. Use the contact details in this statement. ### Does the website respect my motion preferences? Yes. Page transitions and animations are reduced when your device requests reduced motion. --- Source: https://marqius.com/ai/ Markdown: https://marqius.com/aeo/okf/products-and-guides/ai.md AI DOCUMENT WORKFLOWS # Give your AI assistant a PDF tool. Give an MCP-compatible assistant a tool that turns HTML or Markdown into a laid-out PDF. Use Marqius for rendering and keep the source content and review in your workflow. [Discuss an AI Workflow](https://marqius.com/contact)[See How It Works](https://marqius.com/ai/#ai-workflow) ILLUSTRATIVE CONCEPT MCP INTEGRATION ## From approved content to a PDF your team can review. Model Context Protocol (MCP) lets a compatible assistant call Marqius Engine as a tool. The assistant supplies the content. Engine lays it out and returns the PDF. 1. **Prepare the source.** Use an approved template or review the HTML or Markdown your assistant has drafted. 2. **Render the document.** Call `html_to_pdf` with the source, a title and a page size. Marqius produces the laid-out PDF. 3. **Review the result.** Compare key fields with their sources, inspect page breaks and tables, and approve the file before distribution or print. MARQIUS FEATURES ## What supports an AI document workflow [All features](https://marqius.com/features/) INPUTS & OUTPUTS ### Turn source content into finished files Start with HTML, Markdown or a web address. Prepare a PDF for reading or print, an EPUB 3 edition, or page images for review. [Explore feature](https://marqius.com/features/document-conversion/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) ## Try one PDF your assistant needs to produce. A recurring brief, report or letter is a useful first example. Bring an anonymised source and show us what a good result looks like. [Discuss an AI Workflow](https://marqius.com/contact) QUESTIONS & ANSWERS ## Questions about AI document workflows ### How does an AI assistant generate a PDF with Marqius? A compatible assistant calls html\_to\_pdf through the Model Context Protocol. It supplies HTML or Markdown, a title and a page size and receives a laid-out PDF. ### Does the AI decide what goes into the finished document? Your workflow decides which content is approved to render and release. Review the source and the resulting PDF before distribution. ### Can my application generate a PDF directly? Yes. Marqius Engine also provides an HTTP conversion endpoint for applications that submit HTML and receive the PDF. --- Source: https://marqius.com/blog/ Markdown: https://marqius.com/aeo/okf/journal/blog.md MARQIUS JOURNAL # Practical notes for your next print run. Practical guides to PDF generation and print production, from replacing wkhtmltopdf to testing templates and clearing a press proof. [Read the guides](https://marqius.com/blog/#articles) ## PDF and print production guides [ wkhtmltopdf migration November 20, 2026 ### wkhtmltopdf is unmaintained: Your options in 2026 wkhtmltopdf is archived. Try Marqius as a drop-in replacement, compare Chromium, Gotenberg and WeasyPrint, and check your own PDF before switching. Read guide ](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [ wkhtmltopdf migration November 20, 2026 ### Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie Bookworm still has wkhtmltopdf. Trixie removed it. Find out why your install stopped and how Marqius can keep your PDF app working. Read guide ](https://marqius.com/blog/install-wkhtmltopdf-debian/) [ wkhtmltopdf migration November 20, 2026 ### wkhtmltopdf vs headless Chromium: What changes when you switch Try Marqius to keep your current PDF code. Use Chromium when your report needs a browser to load its data or draw its charts. Read guide ](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [ wkhtmltopdf migration November 20, 2026 ### wkhtmltopdf vs Gotenberg: When a PDF API makes sense Try Marqius to keep your PDF call. Consider Gotenberg if several apps need a shared service for invoices, Word files or spreadsheets. Read guide ](https://marqius.com/blog/wkhtmltopdf-vs-gotenberg/) [ wkhtmltopdf migration November 20, 2026 ### Install Marqius wkhtmltopdf with APT on Debian Install Marqius with APT on Debian 12 or 13. Keep your old wkhtmltopdf command while you check a PDF with Marqius. Read guide ](https://marqius.com/blog/install-marqius-with-apt/) [ wkhtmltopdf migration November 20, 2026 ### Migrate Rotativa.AspNetCore off wkhtmltopdf Keep ViewAsPdf and your existing view. Put Marqius in the folder where Rotativa looks. Read guide ](https://marqius.com/blog/migrate-rotativa-off-wkhtmltopdf/) [ wkhtmltopdf migration November 20, 2026 ### Migrate Elixir pdf\_generator off wkhtmltopdf Keep your Elixir PDF call. Set the Marqius path in the release’s runtime settings. Read guide ](https://marqius.com/blog/migrate-elixir-pdf-generator/) [ wkhtmltopdf migration November 20, 2026 ### Switch Java wkhtmltopdf wrapper to the Marqius executable Keep your Java PDF calls. Pass the Marqius path when you create the PDF object. Read guide ](https://marqius.com/blog/migrate-java-wkhtmltopdf-wrapper/) [ wkhtmltopdf migration November 20, 2026 ### Switch go-wkhtmltopdf to the Marqius executable Point the Go library at Marqius at startup. Keep the pages and options you already use. Read guide ](https://marqius.com/blog/migrate-go-wkhtmltopdf/) [ wkhtmltopdf migration November 20, 2026 ### Switch Node.js wkhtmltopdf to the Marqius executable Keep the Node wkhtmltopdf library and its stream. Set the command to Marqius. Read guide ](https://marqius.com/blog/migrate-node-wkhtmltopdf/) [ wkhtmltopdf migration November 20, 2026 ### Migrate Ruby PDFKit off wkhtmltopdf Keep the Ruby PDFKit gem. Give it the Marqius path and check one statement. Read guide ](https://marqius.com/blog/migrate-ruby-pdfkit-off-wkhtmltopdf/) [ wkhtmltopdf migration November 20, 2026 ### Migrate Rails wicked\_pdf off wkhtmltopdf Keep your Rails views and wicked\_pdf. Change the executable path and test the same report. Read guide ](https://marqius.com/blog/migrate-wicked-pdf-off-wkhtmltopdf/) ## Reader questions ### Who is the Marqius Journal for? It’s for teams that prepare recurring statements, letters, catalogues, manuals or other documents for print. ### Where should I start before a first print run? Start with the guide to what to send your printer. It covers trim, bleed, finishing and choosing the pages most likely to expose issues. --- Source: https://marqius.com/blog/install-marqius-with-apt/ Markdown: https://marqius.com/aeo/okf/journal/blog-install-marqius-with-apt.md wkhtmltopdf migration # Install Marqius wkhtmltopdf with APT on Debian Install Marqius with APT on Debian 12 or 13. Keep your old wkhtmltopdf command while you check a PDF with Marqius. Marqius November 20, 2026 Say your invoice app is moving to a new Debian server. You want it to keep making the same PDFs, and you want APT to manage the new PDF program the way it manages your other packages. You can install Marqius through its signed APT source on **Debian 12 or 13**, on **amd64 or arm64**. ## Why this helps The package gives your app a clear path to the new program, `/usr/bin/marqius-wkhtmltopdf`. The old `wkhtmltopdf` command stays available. You can have one app try Marqius while other jobs keep using the old tool, and use APT to manage future updates or remove the package. ## 1\. Open a disposable Debian shell You need Docker running. This example tests Trixie. Use `debian:bookworm-slim` in the same command if you want to try Debian 12. Terminal ``` mkdir -p marqius-apt-demo cd marqius-apt-demo docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash ``` Run the remaining blocks inside that shell. You're already root in this container. To apply the package setup on a real Debian host, run the system changes as a user with sudo. ## 2\. Download and check the signing key Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl gpg poppler-utils curl -fsSLo marqius-archive-keyring.gpg https://marqius.com/download/apt/marqius-archive-keyring.gpg gpg --show-keys --with-fingerprint marqius-archive-keyring.gpg ``` Check for **BFF2 545B B544 3FDB 31CE 801B 421B 8E68 D7C2 2538** before continuing. APT uses this key to check the Marqius package list. ## 3\. Add the source and install the package Terminal ``` install -d -m 0755 /etc/apt/keyrings install -m 0644 marqius-archive-keyring.gpg /etc/apt/keyrings/marqius-archive-keyring.gpg cat > /etc/apt/sources.list.d/marqius.sources <<'SOURCES' Types: deb URIs: https://marqius.com/download/apt/ Suites: stable Components: main Architectures: amd64 arm64 Signed-By: /etc/apt/keyrings/marqius-archive-keyring.gpg SOURCES apt-get update apt-cache policy marqius-wkhtmltopdf apt-get install -y marqius-wkhtmltopdf marqius-wkhtmltopdf --version ``` You should see an available version and then the installed version. The package also installs DejaVu fonts. Your production PDFs may need the same fonts you used on the old server. ## 4\. Make and check a PDF Terminal ``` cd /proof ``` The studio’s **Invoice 1001** uses three Marqius products as line items so you can see how they fit together. **Marqius wkhtmltopdf** keeps your existing PDF call working, **Studio** is where you design the document, and **Relay** generates it from a template and data. The sample amounts add up to **120.00 EUR** including VAT. Open `START-HERE.html` after unzipping to run the invoice and check a page break. [Download the print demo (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-invoice-demo.zip) · [Open the invoice PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-invoice.pdf) If your team also checks files before they go to press, use the sample from Marqius Engine. It has a finished A4 size, 3 mm of bleed, real CMYK colour patches and a 100 mm reference you can measure at actual size. [Open the press test sheet](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-press-proof.pdf) Unzip the demo and put `invoice.html` in your test folder. If you're already in the terminal, you can get the same file with one command. Terminal ``` curl -fsSLo invoice.html https://marqius.com/download/wkhtmltopdf-demo/0.12.8/invoice.html.txt ``` Terminal ``` marqius-wkhtmltopdf --page-size A4 invoice.html invoice-marqius.pdf pdfinfo invoice-marqius.pdf | grep '^Pages:' pdftotext invoice-marqius.pdf - | grep -F '120.00 EUR' exit ``` Open **invoice-marqius.pdf** from the demo folder. If it has one page and reads **Total due: 120.00 EUR**, the converter made the file. In a test copy of your app, set your library's path to **/usr/bin/marqius-wkhtmltopdf** and repeat the test with an invoice your app actually sends. [Exact setting for each library](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) The disposable container goes away when you exit. If you installed on a test host and want to undo it, run `sudo apt-get remove marqius-wkhtmltopdf`. The old `wkhtmltopdf` command stays in place. [Trial and licensing](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Does apt install marqius-wkhtmltopdf replace the existing wkhtmltopdf command? The package installs /usr/bin/marqius-wkhtmltopdf. It leaves the wkhtmltopdf command and the Debian package that owns it in place. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/install-wkhtmltopdf-debian/ Markdown: https://marqius.com/aeo/okf/journal/blog-install-wkhtmltopdf-debian.md wkhtmltopdf migration # Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie Bookworm still has wkhtmltopdf. Trixie removed it. Find out why your install stopped and how Marqius can keep your PDF app working. Marqius November 20, 2026 Say your Docker build worked last week. This week, the same line, `apt install wkhtmltopdf`, says it can’t find the package. Check whether the new image runs **Debian 12 Bookworm** or **Debian 13 Trixie**. Bookworm still has the package. Trixie removed it. [Bookworm package](https://packages.debian.org/bookworm/wkhtmltopdf) · [Debian removal discussion](https://bugs.debian.org/1091821) ## Why this helps You can tell whether you have a missing command or a missing package before changing anything. If your app already makes invoices through a wkhtmltopdf library, Marqius gives it a new PDF program to call. You can keep the invoice code and get your new server or Docker image working. ## 1\. Open the Debian version you want to test With Docker running, use a fresh folder. This opens Debian 13 Trixie. To see the Bookworm behavior, use **debian:bookworm-slim** instead. Terminal ``` mkdir -p marqius-debian-demo cd marqius-debian-demo docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash ``` ## 2\. Check the release and package Run the following inside the container or the Debian server that makes the PDFs. Refresh the APT lists first in a new container. Terminal ``` apt-get update . /etc/os-release printf '%s\n' "$PRETTY_NAME" dpkg --print-architecture command -v wkhtmltopdf || true apt-cache policy wkhtmltopdf ``` **Command not found** means the program name does not resolve. **Unable to locate package** means your package lists have no match. Bookworm should show a package candidate. Trixie removed it, so updating the lists there will not bring it back. On Bookworm, you can install the original distro package with the following commands if you need it for a test: Terminal ``` apt-get install -y wkhtmltopdf wkhtmltopdf --version ``` Debian’s build lacks some features of the upstream patched-Qt build. If your app already makes good PDFs, save one from your current app before you change its server. [Debian package notes](https://packages.debian.org/bookworm/wkhtmltopdf) ## 3\. Install Marqius beside the old program Use this on Bookworm or Trixie. The installer checks the download before setting up the executable. For package management instead, use the [signed APT guide](https://marqius.com/blog/install-marqius-with-apt/). Terminal ``` DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends bash ca-certificates curl fonts-dejavu-core poppler-utils cd /proof curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix "$HOME/.local/bin" --no-wkhtmltopdf export WKHTMLTOPDF_BINARY="$HOME/.local/bin/marqius-wkhtmltopdf" "$WKHTMLTOPDF_BINARY" --version ``` The last line should show **marqius-wkhtmltopdf 0.12.8**. The old command is untouched. ## 4\. Make your first invoice PDF The studio’s **Invoice 1001** uses three Marqius products as line items so you can see how they fit together. **Marqius wkhtmltopdf** keeps your existing PDF call working, **Studio** is where you design the document, and **Relay** generates it from a template and data. The sample amounts add up to **120.00 EUR** including VAT. Open `START-HERE.html` after unzipping to run the invoice and check a page break. [Download the print demo (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-invoice-demo.zip) · [Open the invoice PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-invoice.pdf) If your team also checks files before they go to press, use the sample from Marqius Engine. It has a finished A4 size, 3 mm of bleed, real CMYK colour patches and a 100 mm reference you can measure at actual size. [Open the press test sheet](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-press-proof.pdf) Unzip the demo and put `invoice.html` in your test folder. If you're already in the terminal, you can get the same file with one command. Terminal ``` curl -fsSLo invoice.html https://marqius.com/download/wkhtmltopdf-demo/0.12.8/invoice.html.txt ``` Terminal ``` "$WKHTMLTOPDF_BINARY" --page-size A4 invoice.html invoice-marqius.pdf pdfinfo invoice-marqius.pdf | grep '^Pages:' pdftotext invoice-marqius.pdf - | grep -F '120.00 EUR' exit ``` Open **invoice-marqius.pdf** on your computer and check the total. Set the absolute path where your actual PDF job runs. A program installed on your host will not appear inside your app container, so include it when you build that image. [Find the setting for your library](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) ## Reader questions ### Can I fix Unable to locate package wkhtmltopdf on Trixie with apt update? Refreshing package lists helps when they are stale. Trixie removed wkhtmltopdf from its archive, so updating those lists will not restore it. Choose a replacement or use a separate Bookworm environment for the migration baseline. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [wkhtmltopdf vs Gotenberg: When a PDF API makes sense](https://marqius.com/blog/wkhtmltopdf-vs-gotenberg/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/measure-pdf-batch-speed/ Markdown: https://marqius.com/aeo/okf/journal/blog-measure-pdf-batch-speed.md Production speed # Measure the speed of a PDF batch Measure preparation, rendering and review separately to see what is holding up a print run. Marqius November 17, 2026 Production speed is the time from approved inputs to a file the next team can use. Measuring only when the renderer starts and stops tells you how the renderer behaved. Measure the full job as well so you can see where the team waits. ## Pick a batch you recognise Use a set that includes your smallest file, a long document and one with several large images. Write down the input count, the expected output count and the files that must be ready for the next handoff. ## Measure a fresh run and a repeat Run the full batch first, then try a repeat with unchanged inputs. Change one source and run it again. Confirm that the new file reflects the change and that the others can reuse their previous output. When jobs are independent, compare a sequential run with a parallel one. ## Put the clock beside the proof Record time to the last reviewed PDF, time spent correcting warnings, and the count of files accepted on the first pass. A shorter run matters when it gives the team a usable batch before the deadline. [Explore parallel batch processing](https://marqius.com/features/parallel-batch-processing/) ## Reader questions ### What should I measure if a job is already fast to render? Measure how long the file waits for review and handoff. A queue or a repeated correction can cost more production time than PDF generation. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-cakepdf-off-wkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-cakepdf-off-wkhtmltopdf.md wkhtmltopdf migration # Migrate CakePdf off wkhtmltopdf Keep your CakePdf view and engine. Change the program that turns the view into a PDF. Marqius November 20, 2026 Your CakePHP app gets a receipt ready, with the right order details and layout. CakePdf still needs a program to turn that page into a file. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using CakePdf to ask for a PDF. ## Why this helps Keep the CakePdf engine setting your app already uses and change the path to the program it starts. That lets you test the receipt without rebuilding the CakePHP view. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils php-cli composer php-intl php-mbstring php-xml php-gd mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf export COMPOSER_ALLOW_SUPERUSER=1 "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/cakepdf ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Install the PHP library Terminal ``` cd examples/cakepdf composer install --no-interaction --prefer-dist ``` ### 5\. Make the invoice through PHP Terminal ``` php render.php /proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Keep the WkHtmlToPdfEngine and set its engine.binary value in the existing CakePdf configuration. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in The CakePHP application configuration where you set the CakePdf engine. Retain the existing rendering options unless your comparison identifies a reason to change them. php ``` \Cake\Core\Configure::write('CakePdf.engine', [ 'className' => \CakePdf\Pdf\Engine\WkHtmlToPdfEngine::class, 'binary' => getenv('WKHTMLTOPDF_BINARY'), ]); ``` ## Try it with a document you know Merge this setting into your existing engine array if it carries other options. Produce a PDF using the actual CakePdf view and layout, including the header and footer. The standalone sample verifies the engine call. Your project renders the view before the engine receives HTML. If CakePdf reports an engine lookup error, confirm the class name against the installed plugin version. If the engine loads but fails to start, check the binary path inside the app container. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable CakePdf example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/cakepdf/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=26) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [phpwkhtmltopdf](https://marqius.com/blog/migrate-phpwkhtmltopdf/) · [KnpLabs Snappy](https://marqius.com/blog/migrate-snappy-off-wkhtmltopdf/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Do I need to select a different CakePdf engine class? The existing WkHtmlToPdfEngine continues to start the converter. Set its binary path and preserve the other view and engine settings. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-django-wkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-django-wkhtmltopdf.md wkhtmltopdf migration # Switch django-wkhtmltopdf to the Marqius executable Keep your Django view and template. Change one setting and test the same download. Marqius November 20, 2026 A customer clicks Download Invoice. Django has the page ready, but the PDF tool it tries to start is gone from the new server. The customer is left without a file. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using django-wkhtmltopdf to ask for a PDF. ## Why this helps Change the program in Django’s settings and keep the same Download Invoice view. That gives you one place to make the switch and one familiar page to test. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:bookworm-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils python3 python3-venv mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/django-wkhtmltopdf ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Install Django and its PDF library Terminal ``` python3 -m venv .venv .venv/bin/python -m pip install -r examples/django-wkhtmltopdf/requirements.txt ``` ### 5\. Call the Django PDF library Terminal ``` .venv/bin/python examples/django-wkhtmltopdf/render.py /proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Set WKHTMLTOPDF\_CMD in Django settings. Keep your PDF response class and templates while evaluating the same view with the new binary. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in Django settings.py or the production settings module. Retain the existing rendering options unless your comparison identifies a reason to change them. python ``` import os WKHTMLTOPDF_CMD = os.environ['WKHTMLTOPDF_BINARY'] ``` ## Try it with a document you know Request the original PDF view in staging. Check the stylesheet, logo and PDF response headers from that same view. Static assets may be reachable in your browser yet unavailable from the service container. If a shell render succeeds but the response is missing styles, trace how the view resolves static URLs. Keep your WKHTMLTOPDF\_CMD\_OPTIONS as they were so you can isolate the effect of changing the binary. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable django-wkhtmltopdf example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/django-wkhtmltopdf/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=13) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Python pdfkit](https://marqius.com/blog/migrate-python-pdfkit-off-wkhtmltopdf/) · [Ruby PDFKit](https://marqius.com/blog/migrate-ruby-pdfkit-off-wkhtmltopdf/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Where should I set the path for Django? Set WKHTMLTOPDF\_CMD in the settings module loaded by the deployed process. Restart the web and job processes that use those settings. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-elixir-pdf-generator/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-elixir-pdf-generator.md wkhtmltopdf migration # Migrate Elixir pdf\_generator off wkhtmltopdf Keep your Elixir PDF call. Set the Marqius path in the release’s runtime settings. Marqius November 20, 2026 An Elixir app makes PDF receipts on a background worker. A release moves to a new image and the worker can no longer find the old command. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using Elixir pdf\_generator to ask for a PDF. ## Why this helps Read the program path from the release’s environment. That lets you test a new server or container while keeping the receipt code and the existing PDF call. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils elixir mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/elixir-pdf-generator ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Install Hex and fetch the Elixir library Terminal ``` cd examples/elixir-pdf-generator mix local.hex --force mix deps.get ``` ### 5\. Make the invoice through pdf\_generator Terminal ``` mix run render.exs /proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Configure wkhtml\_path for the pdf\_generator application. Keep your PdfGenerator.generate\_binary call and existing rendering options. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in config/runtime.exs for a Mix release, under the correct environment configuration. Retain the existing rendering options unless your comparison identifies a reason to change them. elixir ``` import Config config :pdf_generator, wkhtml_path: System.fetch_env!("WKHTMLTOPDF_BINARY") ``` ## Try it with a document you know Restart the release and pass the same HTML to the worker that produces the PDF. Check the returned bytes or error and render a receipt containing your currency and locale characters. If `mix run` works from a development shell but the built release fails, inspect the environment provided to the release. Runtime config lets you supply the path without embedding a developer machine path at build time. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable Elixir pdf\_generator example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/elixir-pdf-generator/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=41) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Rotativa.AspNetCore](https://marqius.com/blog/migrate-rotativa-off-wkhtmltopdf/) · [go-wkhtmltopdf](https://marqius.com/blog/migrate-go-wkhtmltopdf/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Where should a Mix release read the binary path? Read the deployed path in runtime configuration and pass it as wkhtml\_path to pdf\_generator. Set the variable before booting the release. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-go-wkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-go-wkhtmltopdf.md wkhtmltopdf migration # Switch go-wkhtmltopdf to the Marqius executable Point the Go library at Marqius at startup. Keep the pages and options you already use. Marqius November 20, 2026 A Go service turns order data into a shipping PDF. It works on a developer’s laptop, but the deployed service can’t find the program it relies on. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using go-wkhtmltopdf to ask for a PDF. ## Why this helps Give the Go library a known path when the service starts. Keep the code that adds pages and writes the shipping PDF, then test it in the same image you deploy. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" golang:1.25-bookworm bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/go-wkhtmltopdf ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Fetch the Go library Terminal ``` cd examples/go-wkhtmltopdf go mod tidy ``` ### 5\. Build and run the Go invoice example Terminal ``` go run . /proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Call wkhtmltopdf.SetPath during Go process startup, before creating a PDF generator. Keep your existing PDFGenerator options and pages. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in Go startup code using github.com/SebastiaanKlippert/go-wkhtmltopdf. Retain the existing rendering options unless your comparison identifies a reason to change them. go ``` wkhtmltopdf.SetPath(os.Getenv("WKHTMLTOPDF_BINARY")) pdfg, err := wkhtmltopdf.NewPDFGenerator() ``` ## Try it with a document you know Keep normal error handling for generator creation and rendering. Validate your configured path at startup. Run the same `NewPageReader` or URL-based job under the deployed image and check document order, page size and output text. Set the path once per process. When you compare two binaries concurrently, run the baseline and candidate in separate processes so a process-wide setting cannot mix the results. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable go-wkhtmltopdf example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/go-wkhtmltopdf/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=35) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Node.js wkhtmltopdf](https://marqius.com/blog/migrate-node-wkhtmltopdf/) · [Java wkhtmltopdf wrapper](https://marqius.com/blog/migrate-java-wkhtmltopdf-wrapper/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### When should Go code call SetPath? Set it during startup before calling NewPDFGenerator, using the complete path inside the environment where the Go service runs. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-java-wkhtmltopdf-wrapper/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-java-wkhtmltopdf-wrapper.md wkhtmltopdf migration # Switch Java wkhtmltopdf wrapper to the Marqius executable Keep your Java PDF calls. Pass the Marqius path when you create the PDF object. Marqius November 20, 2026 A Java batch job sends PDF statements at the end of the day. The job still has all the data, but the new Linux image doesn’t have the PDF program at the old path. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using Java wkhtmltopdf wrapper to ask for a PDF. ## Why this helps Pass the new path where the app creates its PDF object. The Java job can keep building statements the same way while you make sure the new image can start Marqius. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:bookworm-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils default-jdk-headless maven mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/java-wkhtmltopdf-wrapper ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Compile the Java example Terminal ``` cd examples/java-wkhtmltopdf-wrapper mvn -B -q compile ``` ### 5\. Run the Java invoice example Terminal ``` mvn -B -q exec:java -Dexec.mainClass=Smoke -Dexec.args=/proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Pass the executable path through WrapperConfig when constructing Pdf for the jhonnymertz wrapper. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in The Java factory that constructs com.github.jhonnymertz.wkhtmltopdf.wrapper.Pdf. Retain the existing rendering options unless your comparison identifies a reason to change them. java ``` import com.github.jhonnymertz.wkhtmltopdf.wrapper.Pdf; import com.github.jhonnymertz.wkhtmltopdf.wrapper.configurations.WrapperConfig; Pdf pdf = new Pdf(new WrapperConfig(System.getenv("WKHTMLTOPDF_BINARY"))); ``` ## Try it with a document you know Run with the same JDK container and file permissions as the service. Test a document with UTF-8 text and the real font bundle. Inspect the exception or stderr if the wrapper reports that the native process could not start. An executable copied into a Linux image must match the image's CPU architecture. Confirm with `dpkg --print-architecture` on Debian-based images and check the binary's `--version` inside that image. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable Java wkhtmltopdf wrapper example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/java-wkhtmltopdf-wrapper/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=38) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Node.js wkhtmltopdf](https://marqius.com/blog/migrate-node-wkhtmltopdf/) · [go-wkhtmltopdf](https://marqius.com/blog/migrate-go-wkhtmltopdf/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Can the Java dependency install the Linux executable? The wrapper calls an executable it can reach in the running environment. Install or copy the converter as part of your Linux image build and configure the path. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-laravel-snappy-off-wkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-laravel-snappy-off-wkhtmltopdf.md wkhtmltopdf migration # Migrate Laravel Snappy off wkhtmltopdf Keep your Blade template and invoice job. Update the PDF program used by Laravel Snappy. Marqius November 20, 2026 A Laravel app takes orders in the browser and prints invoices in the background. After an update, the orders come through, but the queue keeps failing on the PDF step. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using Laravel Snappy to ask for a PDF. ## Why this helps Set the new program path where Laravel already reads it. You can keep the Blade invoice and the queued job, then check that the background worker picked up the change. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils php-cli composer php-mbstring php-xml php-curl php-zip php-sqlite3 mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf export COMPOSER_ALLOW_SUPERUSER=1 "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/laravel-snappy ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Start a small Laravel app and add Snappy Terminal ``` composer create-project laravel/laravel laravel-demo '^12.0' --no-interaction --prefer-dist cd laravel-demo composer require barryvdh/laravel-snappy --no-interaction --prefer-dist ``` ### 5\. Give Snappy the new program and run the invoice job Terminal ``` cp ../examples/laravel-snappy/render.php . WKHTML_PDF_BINARY="$WKHTMLTOPDF_BINARY" php render.php /proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Set WKHTML\_PDF\_BINARY for the Laravel Snappy PDF configuration. Rebuild the configuration cache and restart persistent PDF workers as part of the rollout. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in The Laravel application's environment, commonly its .env file. Retain the existing rendering options unless your comparison identifies a reason to change them. dotenv ``` WKHTML_PDF_BINARY=/usr/bin/marqius-wkhtmltopdf ``` ## Try it with a document you know If config/snappy.php is customized, confirm that pdf.binary reads WKHTML\_PDF\_BINARY. Run `php artisan config:cache` if your deployment caches configuration. Submit a real queued invoice job and check that it uses the updated deployment. If new web requests work while background PDFs still use the old binary, restart persistent queue workers through your usual deployment process. Check the environment in the queue container as well as the web container. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable Laravel Snappy example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/laravel-snappy/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=18) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [KnpLabs Snappy](https://marqius.com/blog/migrate-snappy-off-wkhtmltopdf/) · [Symfony KnpSnappyBundle](https://marqius.com/blog/migrate-symfony-knp-snappy-bundle/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Why does Laravel still use the old path after I edit .env? A cached configuration or long-running queue worker may retain the old value. Rebuild the configuration cache and restart the workers that render PDFs. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-node-wkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-node-wkhtmltopdf.md wkhtmltopdf migration # Switch Node.js wkhtmltopdf to the Marqius executable Keep the Node wkhtmltopdf library and its stream. Set the command to Marqius. Marqius November 20, 2026 A Node app starts a PDF job and writes the result to a file as it comes in. The job fails on the new image because the old PDF command isn’t there. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using Node.js wkhtmltopdf to ask for a PDF. ## Why this helps Change the command the Node library starts. The app can keep writing the PDF through the same stream. Wait for the file to finish before checking it. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" node:22-bookworm-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/node-wkhtmltopdf ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Install the Node wkhtmltopdf package Terminal ``` cd examples/node-wkhtmltopdf npm install ``` ### 5\. Wait for the PDF stream to finish Terminal ``` node render.js /proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Set the Node wrapper's command property at process start. Keep the returned stream and wait for it to reach the output file before reading the PDF. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in The module where your app initializes the wkhtmltopdf npm package. Retain the existing rendering options unless your comparison identifies a reason to change them. javascript ``` const wkhtmltopdf = require('wkhtmltopdf'); wkhtmltopdf.command = process.env.WKHTMLTOPDF_BINARY; ``` ## Try it with a document you know Use your existing pipeline or stream handler and wait for completion. Test an actual request and check PDF text and page count after the stream ends. A process that reads early can mistake an incomplete file for a rendering failure. On a server or in a container, set the variable in the environment of the Node process. If your template uses JavaScript, test whether all rows and amounts are actually present in the finished PDF. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable Node.js wkhtmltopdf example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/node-wkhtmltopdf/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=33) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [go-wkhtmltopdf](https://marqius.com/blog/migrate-go-wkhtmltopdf/) · [Java wkhtmltopdf wrapper](https://marqius.com/blog/migrate-java-wkhtmltopdf-wrapper/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Does this apply to Puppeteer? This guide applies to the wkhtmltopdf npm package that spawns a CLI. Puppeteer drives Chromium through a different interface. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-phpwkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-phpwkhtmltopdf.md wkhtmltopdf migration # Switch phpwkhtmltopdf to the Marqius executable Keep the same PHP calls. Set the binary option to Marqius and check the file. Marqius November 20, 2026 Your PHP app builds an order confirmation, adds it to a PDF and saves it. A server rebuild removed the program that the PHP library runs to make the file. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using phpwkhtmltopdf to ask for a PDF. ## Why this helps Change the path you pass to the library. Your code can still add the same pages and save to the same place while you check a fresh order confirmation. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils php-cli composer mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf export COMPOSER_ALLOW_SUPERUSER=1 "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/phpwkhtmltopdf ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Install the PHP library Terminal ``` cd examples/phpwkhtmltopdf composer install --no-interaction --prefer-dist ``` ### 5\. Make the invoice through PHP Terminal ``` php render.php /proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Set the binary option on mikehaertl's Pdf object. Keep addPage and saveAs, including your application's existing error handling. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in The PHP code that constructs mikehaertl\\wkhtmlto\\Pdf. Retain the existing rendering options unless your comparison identifies a reason to change them. php ``` $pdf = new \mikehaertl\wkhtmlto\Pdf(['binary' => getenv('WKHTMLTOPDF_BINARY')]); $pdf->addPage($html); if (!$pdf->saveAs($outputPath)) { throw new \RuntimeException($pdf->getError()); } ``` ## Try it with a document you know Use an order confirmation with several pages and the same output path permissions as production. Check that saveAs succeeds and that the destination is a complete PDF. Keep its options and page order the same for the first comparison. An empty file can indicate a subprocess or output-directory error. Read getError from the failed render and verify that PHP receives the binary environment variable. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable phpwkhtmltopdf example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/phpwkhtmltopdf/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=20) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [CakePdf](https://marqius.com/blog/migrate-cakepdf-off-wkhtmltopdf/) · [KnpLabs Snappy](https://marqius.com/blog/migrate-snappy-off-wkhtmltopdf/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Which phpwkhtmltopdf setting selects the executable? The binary option on the Pdf constructor selects the executable. Keep your other constructor options as they are for your first test. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-python-pdfkit-off-wkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-python-pdfkit-off-wkhtmltopdf.md wkhtmltopdf migration # Migrate Python pdfkit off wkhtmltopdf Keep Python pdfkit. Change the PDF program it starts and check one invoice. Marqius November 20, 2026 Your Python app has already worked out the tax and total for an invoice. It hands the finished page to pdfkit. If wkhtmltopdf is missing on the new server, that last step is where the job stops. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using Python pdfkit to ask for a PDF. ## Why this helps Point pdfkit at Marqius and keep the Python code that builds the invoice. You can fix the missing PDF step without touching the code that calculates what the customer owes. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:bookworm-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils python3 python3-venv mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/python-pdfkit ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Install pdfkit in a Python environment Terminal ``` python3 -m venv .venv .venv/bin/python -m pip install -r examples/python-pdfkit/requirements.txt ``` ### 5\. Make the invoice through pdfkit Terminal ``` .venv/bin/python examples/python-pdfkit/render.py /proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Pass an absolute executable path to pdfkit.configuration and hand that configuration to the same from\_string, from\_file or from\_url call you already use. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in Python code where your app creates the pdfkit configuration. Retain the existing rendering options unless your comparison identifies a reason to change them. python ``` import os import pdfkit config = pdfkit.configuration(wkhtmltopdf=os.environ['WKHTMLTOPDF_BINARY']) pdfkit.from_string(html, 'invoice.pdf', configuration=config, options={'page-size': 'A4'}) ``` ## Try it with a document you know Run the render from the web or background process that actually sends your invoices. Shell PATH and worker PATH can differ. For a long invoice, make sure the repeated headings, VAT totals and last row survive the page break. If pdfkit says it cannot find an executable, set the variable in the service environment and check that the service user can execute that exact path. Preserve your existing options dictionary and CSS assets while you compare output. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable Python pdfkit example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/python-pdfkit/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=7) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [django-wkhtmltopdf](https://marqius.com/blog/migrate-django-wkhtmltopdf/) · [Ruby PDFKit](https://marqius.com/blog/migrate-ruby-pdfkit-off-wkhtmltopdf/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Do I need to replace the Python pdfkit package? Keep pdfkit and pass a configuration object that points to the new executable. The separate converter needs to be installed in the environment where Python runs. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-rotativa-off-wkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-rotativa-off-wkhtmltopdf.md wkhtmltopdf migration # Migrate Rotativa.AspNetCore off wkhtmltopdf Keep ViewAsPdf and your existing view. Put Marqius in the folder where Rotativa looks. Marqius November 20, 2026 An ASP.NET Core app returns invoices with Rotativa. The controller still has the order details, but its publish folder is missing the program Rotativa looks for. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using Rotativa.AspNetCore to ask for a PDF. ## Why this helps Keep the controller and view. Put Marqius where Rotativa already looks for the wkhtmltopdf file, then check one invoice through the actual web route. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" mcr.microsoft.com/dotnet/sdk:10.0 bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/rotativa-aspnetcore ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Put Marqius where Rotativa looks and build the app Terminal ``` cd examples/rotativa-aspnetcore mkdir -p wwwroot/Rotativa install -m 0755 "$WKHTMLTOPDF_BINARY" wwwroot/Rotativa/wkhtmltopdf dotnet build --configuration Release ``` ### 5\. Call the invoice route and stop the test app Terminal ``` ASPNETCORE_URLS=http://127.0.0.1:5043 dotnet run --no-build --configuration Release > /proof/server.log 2>&1 & server_pid=$! curl -fsS --retry 20 --retry-connrefused --retry-delay 1 --max-time 5 http://127.0.0.1:5043/invoice -o /proof/invoice.pdf kill "$server_pid" ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Keep ViewAsPdf and supply Marqius under the wkhtmltopdf filename in the directory RotativaConfiguration.Setup selects. This guide covers Rotativa.AspNetCore on Linux. Use the Linux download for the CPU architecture of your deployed container. If using the APT package, copy its executable into the directory Rotativa expects under the name `wkhtmltopdf` as part of the application build. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in Program.cs and your publish or container build. This setup expects the executable under the configured web root's Rotativa directory.. Retain the existing rendering options unless your comparison identifies a reason to change them. csharp ``` Rotativa.AspNetCore.RotativaConfiguration.Setup(app.Environment.WebRootPath, "Rotativa"); ``` ## Try it with a document you know During deployment, put the Marqius Linux binary at `wwwroot/Rotativa/wkhtmltopdf` and give it execute permission. Prevent requests from serving that directory as static files. If you already use another directory, retain that one and confirm the resolved path in staging. Check that the publish artifact includes the binary. Render the real MVC action in staging and inspect margins, repeated table headings and the footer. Direct libwkhtmltox bindings such as DinkToPdf have a different integration and cannot use this setup line. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable Rotativa.AspNetCore example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/rotativa-aspnetcore/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=44) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Elixir pdf\_generator](https://marqius.com/blog/migrate-elixir-pdf-generator/) · [go-wkhtmltopdf](https://marqius.com/blog/migrate-go-wkhtmltopdf/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Does RotativaConfiguration.Setup take the executable path? In this example it selects a directory under the web root. Rotativa looks for the wkhtmltopdf filename inside that directory. Verify the resolved path for your installed version. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-ruby-pdfkit-off-wkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-ruby-pdfkit-off-wkhtmltopdf.md wkhtmltopdf migration # Migrate Ruby PDFKit off wkhtmltopdf Keep the Ruby PDFKit gem. Give it the Marqius path and check one statement. Marqius November 20, 2026 Your Ruby app takes a statement it already knows how to build and gives that page to PDFKit. After a machine change, PDFKit can’t find the tool needed to write the file. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using Ruby PDFKit to ask for a PDF. ## Why this helps Change the program in PDFKit’s startup settings. The code that prepares the statement can stay in place while you check the PDF from a real web request. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils ruby ruby-bundler mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/ruby-pdfkit ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Install the Ruby gems for this example Terminal ``` cd examples/ruby-pdfkit bundle install ``` ### 5\. Make the invoice through the gem Terminal ``` bundle exec ruby render.rb /proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Set config.wkhtmltopdf in the Ruby PDFKit configuration. Existing PDFKit.new and to\_file calls can keep the same HTML and options. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in Your Rails initializer or the startup code that configures the pdfkit gem. Retain the existing rendering options unless your comparison identifies a reason to change them. ruby ``` PDFKit.configure do |config| config.wkhtmltopdf = ENV.fetch('WKHTMLTOPDF_BINARY') end ``` ## Try it with a document you know Test the code path you really use. If PDFKit runs as middleware, make a request that exercises it. Check the same margins and stylesheet loading so you can distinguish initialization issues from layout changes. If the path changes in a console but not in web requests, check initialization order and restart the deployed process. This setting belongs to the Ruby gem and differs from Python pdfkit's configuration object. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable Ruby PDFKit example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/ruby-pdfkit/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=31) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Python pdfkit](https://marqius.com/blog/migrate-python-pdfkit-off-wkhtmltopdf/) · [django-wkhtmltopdf](https://marqius.com/blog/migrate-django-wkhtmltopdf/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Does Ruby PDFKit use the same setting as Python pdfkit? Ruby uses PDFKit.configure and config.wkhtmltopdf. Python passes the executable path to pdfkit.configuration. Each guide shows the setting for its own library. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-snappy-off-wkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-snappy-off-wkhtmltopdf.md wkhtmltopdf migration # Migrate KnpLabs Snappy off wkhtmltopdf Keep KnpLabs Snappy and your PHP invoice code. Give Snappy a new PDF program. Marqius November 20, 2026 Your PHP app uses Snappy to turn orders into PDFs. The order screen still works after a server move, but the printed invoice never arrives. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using KnpLabs Snappy to ask for a PDF. ## Why this helps Give the Snappy PDF object the path to Marqius. The order code can still ask Snappy for a PDF the same way, so you can test this change with a single order. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils php-cli composer mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf export COMPOSER_ALLOW_SUPERUSER=1 "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/knplabs-snappy ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Install the PHP library Terminal ``` cd examples/knplabs-snappy composer install --no-interaction --prefer-dist ``` ### 5\. Make the invoice through PHP Terminal ``` php render.php /proof/invoice.pdf ``` ### 6\. Check that the PDF contains the right invoice Terminal ``` pdfinfo /proof/invoice.pdf | grep '^Pages:' pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001' pdftotext /proof/invoice.pdf - | grep -F '120.00' chmod a+r /proof/invoice.pdf ``` Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer. ## How to switch your own app to Marqius Pass the new executable path to the Knp Snappy Pdf constructor where you build your PDF service. Keep the same getOutputFromHtml or generateFromHtml call. Install Marqius alongside the original. Set `WKHTMLTOPDF_BINARY` in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs `/usr/bin/marqius-wkhtmltopdf`. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/) Apply the change in Your PHP factory or service definition for Knp\\Snappy\\Pdf. Retain the existing rendering options unless your comparison identifies a reason to change them. php ``` $snappy = new \Knp\Snappy\Pdf(getenv('WKHTMLTOPDF_BINARY')); $snappy->generateFromHtml($html, $outputPath, ['page-size' => 'A4']); ``` ## Try it with a document you know Render a multi-page PDF with your usual options and verify the invoice totals, A4 size and footer. Run under the same PHP worker user as the app so temp directory permissions and environment settings match production. If the app uses Laravel's service provider or Symfony's bundle, change the framework setting in the corresponding guide. A standalone constructor change has no effect on a framework service supplied elsewhere. ## Check the old and new PDFs Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable KnpLabs Snappy example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/knplabs-snappy/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=16) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers. [All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Laravel Snappy](https://marqius.com/blog/migrate-laravel-snappy-off-wkhtmltopdf/) · [Symfony KnpSnappyBundle](https://marqius.com/blog/migrate-symfony-knp-snappy-bundle/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/) ## Reader questions ### Does the Snappy constructor take the binary or a directory? Pass the executable's full path. Keep its parent directory accessible to the user running PHP. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/migrate-symfony-knp-snappy-bundle/ Markdown: https://marqius.com/aeo/okf/journal/blog-migrate-symfony-knp-snappy-bundle.md wkhtmltopdf migration # Migrate Symfony KnpSnappyBundle off wkhtmltopdf Keep your Symfony PDF service. Point its Snappy setting at Marqius. Marqius November 20, 2026 A Symfony app generates statements through its Snappy service. A new container starts fine, but building a statement fails because the service still points at the old program. **Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using Symfony KnpSnappyBundle to ask for a PDF. ## Why this helps Change the path in the bundle’s settings. The controllers and commands can keep using the same Symfony service, so you can try the switch in one environment first. ## Make your first PDF Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf) With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container. ### 1\. Open a fresh test container Terminal ``` docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash ``` Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test. ### 2\. Install the tools and Marqius Terminal ``` apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils php-cli composer php-mbstring php-xml php-curl php-zip php-sqlite3 mkdir -p /work cd /work curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh bash install-marqius.sh --version 0.12.8 --prefix /work/bin export PATH="/work/bin:$PATH" export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf export COMPOSER_ALLOW_SUPERUSER=1 "$WKHTMLTOPDF_BINARY" --version wkhtmltopdf --version ``` The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container. ### 3\. Bring the demo project into the test container Terminal ``` cd /work if [ -d /proof/examples/knp-snappy-bundle ]; then cp -R /proof/examples . else curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip && unzip -oq wrapper-demos.zip fi ``` ### 4\. Start a small Symfony app and add the PDF bundle Terminal ``` composer create-project 'symfony/skeleton:^7.4' symfony-demo --no-interaction --prefer-dist cd symfony-demo composer require symfony/framework-bundle symfony/console symfony/yaml knplabs/knp-snappy-bundle --no-interaction --prefer-dist ``` ### 5\. Add the bundle and the sample command Terminal ``` php -r '$file = "config/bundles.php"; $bundles = require $file; $bundles["Knp\\Bundle\\SnappyBundle\\KnpSnappyBundle"] = ["all" => true]; file_put_contents($file, " mine/options.txt ./run.sh mine ``` Open **out/mine/report.html**. You’ll get both PDFs and a report showing where they differ. To test one of your own documents, replace the sample HTML in **mine/**, include the fonts and images it needs, and write your app’s options in **mine/options.txt**. Run the last command again. [Template setup notes](https://github.com/marqiushq/wkhtmltopdf-parity/tree/main/mine) On **20 November 2026**, Marqius 0.12.8 scored **0.9924 across 86 core documents** against wkhtmltopdf 0.12.6. The score combines text, word positions and page count. Ink overlap is measured separately, and the full run includes other cases such as languages and CLI options. [Scoreboard and method](https://github.com/marqiushq/wkhtmltopdf-parity#readme) · [This CI run](https://github.com/marqiushq/wkhtmltopdf-parity/actions/runs/44683724131) [Latest results](https://github.com/marqiushq/wkhtmltopdf-parity/tree/main/results) · [Issue tracker](https://github.com/marqiushq/wkhtmltopdf-parity/issues) · [CI run history](https://github.com/marqiushq/wkhtmltopdf-parity/actions) ## Find the setting for your wrapper A wrapper is the library your app uses to start the PDF program. Each guide runs a sample invoice before showing how to make the same change in your app. - [Python pdfkit](https://marqius.com/blog/migrate-python-pdfkit-off-wkhtmltopdf/) - [django-wkhtmltopdf](https://marqius.com/blog/migrate-django-wkhtmltopdf/) - [KnpLabs Snappy](https://marqius.com/blog/migrate-snappy-off-wkhtmltopdf/) - [Laravel Snappy](https://marqius.com/blog/migrate-laravel-snappy-off-wkhtmltopdf/) - [phpwkhtmltopdf](https://marqius.com/blog/migrate-phpwkhtmltopdf/) - [Symfony KnpSnappyBundle](https://marqius.com/blog/migrate-symfony-knp-snappy-bundle/) - [CakePdf](https://marqius.com/blog/migrate-cakepdf-off-wkhtmltopdf/) - [Rails wicked\_pdf](https://marqius.com/blog/migrate-wicked-pdf-off-wkhtmltopdf/) - [Ruby PDFKit](https://marqius.com/blog/migrate-ruby-pdfkit-off-wkhtmltopdf/) - [Node.js wkhtmltopdf](https://marqius.com/blog/migrate-node-wkhtmltopdf/) - [go-wkhtmltopdf](https://marqius.com/blog/migrate-go-wkhtmltopdf/) - [Java wkhtmltopdf wrapper](https://marqius.com/blog/migrate-java-wkhtmltopdf-wrapper/) - [Elixir pdf\_generator](https://marqius.com/blog/migrate-elixir-pdf-generator/) - [Rotativa.AspNetCore](https://marqius.com/blog/migrate-rotativa-off-wkhtmltopdf/) ## Compare the five options | Tool | Status and how it runs | What happens to existing templates | JavaScript | How to check a switch | | --- | --- | --- | --- | --- | | Marqius | Maintained proprietary command-line program | Keep your wrapper and template for a first test. Some flags or layouts can differ. | Limited in the native renderer. Test pages that depend on scripts. | Run both programs with the same files using the public harness above. | | wkhtmltopdf | Archived command-line program | Keep your existing output as a baseline. | Old QtWebKit. | Save one of the PDFs your app already sends. | | Headless Chromium | Maintained browser, controlled from a script or command | Map PDF options and check print CSS, headers and page breaks. | Browser JavaScript. Wait for the page to finish loading. | [Print the same invoice in Chromium](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/). | | Gotenberg | Maintained open-source service, typically run in Docker | Send HTML over HTTP. Its HTML route uses Chromium, so check the print layout. | Browser JavaScript on Chromium routes. | [Send the same invoice to a local test service](https://marqius.com/blog/wkhtmltopdf-vs-gotenberg/). | | WeasyPrint | Maintained open-source Python library and command | Test your print CSS. If JavaScript builds the page, prepare that HTML before sending it. | No browser JavaScript. | Render the same HTML and compare the pages. | If the app directly loads `libwkhtmltox`, plan an integration change. A new command by itself cannot replace a shared library. [WeasyPrint documentation](https://doc.courtbouillon.org/weasyprint/stable/first_steps.html) Marqius publishes this guide. Start with the option that fits the way your app makes PDFs today. ## Reader questions ### Is wkhtmltopdf safe to keep using? The upstream project is archived and no longer publishes fixes there. Its maintainer warns against converting HTML from untrusted sources. If you still rely on it, keep the job away from untrusted input while you plan and test the switch. ### Why was wkhtmltopdf discontinued? It depended on an old version of QtWebKit that became difficult to maintain. The upstream repository was archived in January 2023. Debian later removed the package from Trixie. ### Can I install wkhtmltopdf on Debian 12 or Ubuntu 26.04? Debian 12 Bookworm still has its own wkhtmltopdf package. The standard Ubuntu 26.04 archive had no published package for amd64 or arm64 when we checked. Run apt-cache policy wkhtmltopdf after apt-get update to see what your enabled sources offer. ### What is the closest drop-in replacement for wkhtmltopdf? If your app starts a wkhtmltopdf executable, Marqius is designed for that call. Point the wrapper at Marqius and check one PDF through the actual app. An integration that loads libwkhtmltox directly needs a separate change. ### Is Gotenberg enough to replace wkhtmltopdf? Gotenberg may fit if you want a shared service or also make PDFs from Office files. Apps that currently start wkhtmltopdf need to send a request to Gotenberg instead and check the new output. ### Do I have to rewrite my templates? With Marqius, start with the same templates. Check how your PDFs use fonts, scripts, headers and page breaks, then fix the differences that matter to your documents. ## Keep reading [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [wkhtmltopdf vs Gotenberg: When a PDF API makes sense](https://marqius.com/blog/wkhtmltopdf-vs-gotenberg/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/wkhtmltopdf-vs-gotenberg/ Markdown: https://marqius.com/aeo/okf/journal/blog-wkhtmltopdf-vs-gotenberg.md wkhtmltopdf migration # wkhtmltopdf vs Gotenberg: When a PDF API makes sense Try Marqius to keep your PDF call. Consider Gotenberg if several apps need a shared service for invoices, Word files or spreadsheets. Marqius November 20, 2026 A shop has one app that makes PDF invoices. A larger team has three apps sending documents, including Word files and spreadsheets. The shop may need to change one program. The larger team may want one place to send all kinds of files. ## Why this helps **Marqius helps the first team keep its app working.** If the app already starts wkhtmltopdf, install Marqius beside it and change the program path in the app’s PDF library. Keep the existing templates, then compare one invoice before switching. [Find the setting for your library](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) **Gotenberg helps the second team share one PDF service.** Apps send their files to it and get PDFs back. It uses Chromium for web pages and LibreOffice for Word or Excel files. Choose it when you want that shared service and have a team to run it. If your app currently starts wkhtmltopdf, the app will need to send a request to the service instead. [Gotenberg project](https://github.com/gotenberg/gotenberg) · [Conversion routes](https://gotenberg.dev/docs/8.x/getting-started/routes) ## How to choose 1. **If you want to keep the existing PDF call,** try Marqius with the library you already use. 2. **If you want one service for several apps,** try Gotenberg with a real file from each app. 3. **Before moving your live jobs,** save the old PDFs and check that the new ones have the right content, layout and page count. ## Make the same invoice both ways You need Docker and curl 7.71 or newer. Both commands render the same static invoice. The first calls Marqius like a command. The second sends the file to a test service. ### 1\. Set up the sample Terminal ``` mkdir -p marqius-gotenberg-demo cd marqius-gotenberg-demo ``` The studio’s **Invoice 1001** uses three Marqius products as line items so you can see how they fit together. **Marqius wkhtmltopdf** keeps your existing PDF call working, **Studio** is where you design the document, and **Relay** generates it from a template and data. The sample amounts add up to **120.00 EUR** including VAT. Open `START-HERE.html` after unzipping to run the invoice and check a page break. [Download the print demo (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-invoice-demo.zip) · [Open the invoice PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-invoice.pdf) If your team also checks files before they go to press, use the sample from Marqius Engine. It has a finished A4 size, 3 mm of bleed, real CMYK colour patches and a 100 mm reference you can measure at actual size. [Open the press test sheet](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-press-proof.pdf) Unzip the demo and put `invoice.html` in your test folder. If you're already in the terminal, you can get the same file with one command. Terminal ``` curl -fsSLo invoice.html https://marqius.com/download/wkhtmltopdf-demo/0.12.8/invoice.html.txt ``` ### 2\. Make the PDF with Marqius Terminal ``` docker run --rm --network none --mount "type=bind,source=$PWD,target=/data" \ marqius/wkhtmltopdf:0.12.8 --page-size A4 invoice.html invoice-marqius.pdf ``` ### 3\. Start the Gotenberg test service Terminal ``` service_id=$(docker run -d --rm -p 127.0.0.1:3100:3000 gotenberg/gotenberg:8-chromium) curl -fsS --retry 15 --retry-all-errors --retry-delay 1 --max-time 5 http://127.0.0.1:3100/health ``` The service listens on your computer only. This smaller image is enough for HTML. Use the full Gotenberg image to test Word or spreadsheet conversion. ### 4\. Send the invoice and get the PDF back Terminal ``` cp invoice.html index.html curl -fsS --max-time 60 --form 'files=@index.html' --form 'preferCssPageSize=true' \ http://127.0.0.1:3100/forms/chromium/convert/html -o invoice-gotenberg.pdf ls -lh invoice-marqius.pdf invoice-gotenberg.pdf docker stop "$service_id" ``` Gotenberg expects **index.html** as the main file. If your real document has a local stylesheet, add another form part for that file and keep the name used by your HTML. [Gotenberg HTML route](https://gotenberg.dev/docs/chromium/convert-html) Open both PDFs. Check the heading, the **120.00 EUR** total and where the table sits on the page. Think about which change your app needs. To try Marqius, change the program path in your existing PDF library. To use Gotenberg, add an HTTP request and handle the response or error. The [public scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) covers the separate comparison of wkhtmltopdf and Marqius. ## Reader questions ### Can Gotenberg be installed as the wkhtmltopdf executable? Gotenberg exposes HTTP endpoints. To switch an app that calls wkhtmltopdf, change the integration to submit an HTTP request and handle a PDF response. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/ Markdown: https://marqius.com/aeo/okf/journal/blog-wkhtmltopdf-vs-headless-chromium.md wkhtmltopdf migration # wkhtmltopdf vs headless Chromium: What changes when you switch Try Marqius to keep your current PDF code. Use Chromium when your report needs a browser to load its data or draw its charts. Marqius November 20, 2026 Picture two documents. One is a plain invoice your app already sends through wkhtmltopdf. The other is a report whose charts only appear after the browser loads more data. Those two documents can point you toward different tools. ## Why this helps **For the existing invoice, start with Marqius.** It’s a drop-in replacement for apps that start the wkhtmltopdf program. In a test copy of the app, point your library at Marqius, keep your invoice code and print the invoice again. [Find your library’s setting](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) **For the report that needs a browser, try Chromium.** Headless Chromium is a browser that runs without an open window. Your app can tell it to load the report, wait for the chart and then print. That helps when a regular browser is already what makes the report work. You’ll need to change the PDF call and set up the print options. ## What changes in practice | Existing wkhtmltopdf input | What to check with Chromium | | --- | --- | | `--page-size`, margins, orientation and zoom | Choose page format and margins in the PDF API or `@page`. Set `preferCSSPageSize` deliberately and compare the resulting page dimensions. | | HTML headers and footers with page variables | Map them to `headerTemplate` and `footerTemplate`. Enable `displayHeaderFooter`, allocate margin space, and use Chromium's `pageNumber` and `totalPages` classes. | | `--javascript-delay` or a completion signal | Wait for an app-defined ready element or condition. Wait for fonts too. A timer alone does not establish that the last table row arrived. | | Screen CSS or `--print-media-type` | Puppeteer PDF generation uses print CSS by default. Compare the result with what the old invocation used and choose the media explicitly if required. | | CSS, fonts and images beside a local file | Make each resource reachable from the browser's environment. For HTML supplied as a string, check how relative links are resolved. | | A wkhtmltopdf table of contents or several input objects | Plan the document structure or assembly step explicitly. The browser PDF call prints one page context and does not parse wkhtmltopdf flags. | [Puppeteer Page.pdf](https://pptr.dev/api/puppeteer.page.pdf) · [Puppeteer PDF options](https://pptr.dev/api/puppeteer.pdfoptions) ## Try both tools with the same invoice These commands use a Debian 12 or 13 machine where you can run Docker and install Chromium. Run the browser from your regular user shell. Start with the sample invoice so both tools receive the exact same HTML. ### 1\. Set up Chromium and get the sample Terminal ``` sudo apt-get update sudo apt-get install -y chromium curl fonts-dejavu-core poppler-utils mkdir -p marqius-chromium-demo cd marqius-chromium-demo ``` The studio’s **Invoice 1001** uses three Marqius products as line items so you can see how they fit together. **Marqius wkhtmltopdf** keeps your existing PDF call working, **Studio** is where you design the document, and **Relay** generates it from a template and data. The sample amounts add up to **120.00 EUR** including VAT. Open `START-HERE.html` after unzipping to run the invoice and check a page break. [Download the print demo (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-invoice-demo.zip) · [Open the invoice PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-invoice.pdf) If your team also checks files before they go to press, use the sample from Marqius Engine. It has a finished A4 size, 3 mm of bleed, real CMYK colour patches and a 100 mm reference you can measure at actual size. [Open the press test sheet](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-press-proof.pdf) Unzip the demo and put `invoice.html` in your test folder. If you're already in the terminal, you can get the same file with one command. Terminal ``` curl -fsSLo invoice.html https://marqius.com/download/wkhtmltopdf-demo/0.12.8/invoice.html.txt ``` ### 2\. Print it with Marqius Terminal ``` docker run --rm --network none --mount "type=bind,source=$PWD,target=/data" \ marqius/wkhtmltopdf:0.12.8 --page-size A4 invoice.html invoice-marqius.pdf ``` ### 3\. Print the same HTML in Chromium Terminal ``` chromium --headless --user-data-dir="$PWD/chromium-demo-profile" \ --no-pdf-header-footer --print-to-pdf="$PWD/invoice-chromium.pdf" \ "file://$PWD/invoice.html" ``` The profile is separate from your usual browser profile. If this is a report that loads more data after the page opens, drive Chromium from your app and wait for its ready signal before printing. The demo is a static invoice so you can compare the same input immediately. [Puppeteer PDF options](https://pptr.dev/api/puppeteer.pdfoptions) ### 4\. Check the results Terminal ``` for pdf in invoice-marqius.pdf invoice-chromium.pdf; do printf '\n%s\n' "$pdf" pdfinfo "$pdf" | grep -E '^(Pages|Page size):' pdftotext "$pdf" - | grep -F '120.00 EUR' done ``` Both should show one A4 page and **120.00 EUR**. Open them side by side to see where the table and total land. For the actual app, use a document that reaches a second page and one that needs JavaScript. The [public scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) covers the separate comparison of wkhtmltopdf and Marqius. [Use the harness with your own templates](https://github.com/marqiushq/wkhtmltopdf-parity#check-your-own-templates). ## Reader questions ### Can I point pdfkit or Snappy at headless Chromium? Those wrappers expect the wkhtmltopdf command-line interface. Drive Chromium through a browser library or an HTTP service and map the PDF settings. ## Keep reading [wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs Gotenberg: When a PDF API makes sense](https://marqius.com/blog/wkhtmltopdf-vs-gotenberg/) [All journal guides](https://marqius.com/blog/) --- Source: https://marqius.com/cli/ Markdown: https://marqius.com/aeo/okf/products-and-guides/cli.md 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. [Make a sample PDF](https://marqius.com/cli/#quickstart) [Download agent skills](https://marqius.com/cli/#skills) [Install the CLI](https://marqius.com/cli/#install) [](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-invoice.pdf) Terminal v0.12.8 marqius-wkhtmltopdf --page-size A4 invoice.html invoice.pdf pdfinfo invoice.pdf | grep '^Pages:' Pages: 1 [Open the generated invoice](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-invoice.pdf) ## 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 ``` [All downloads](https://marqius.com/wkhtmltopdf/download/) [Install on Debian with APT](https://marqius.com/blog/install-marqius-with-apt/) ## 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. [Download both skills](https://marqius.com/download/marqius-cli/marqius-agent-skills.zip)[SHA-256 checksum](https://marqius.com/download/marqius-cli/marqius-agent-skills.zip.sha256) ### 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](https://learn.chatgpt.com/docs/build-skills) ## 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](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-invoice.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 ``` ## Command reference [Open the developer manual](https://marqius.com/download/developer-manual.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. --- Source: https://marqius.com/contact/ Markdown: https://marqius.com/aeo/okf/products-and-guides/contact.md TALK TO US # Tell us what you print every day. Tell us what goes into each batch, who checks it and where it goes after approval. That gives us something concrete to discuss: what your first proof should show. CONTACT **Simple AI LLC** 1209 Mountain Road Pl NE, Ste N Albuquerque, NM 87110 United States [Telegram: +1 505 305 1025](https://t.me/+15053051025) WHAT TO EXPECT 01 ### Share the challenge Tell us about the documents and work that repeats. 02 ### Review an example Discuss the changing information and the result you need. 03 ### Explore the next step Assess the fit and define the workflow and scope to consider. QUESTIONS & ANSWERS ## Before you get in touch ### What should I include in a first enquiry? Describe your document type, what changes between runs and the main step you want to improve. Avoid sharing confidential or personal records. ### How do I send an enquiry? The form opens a Telegram draft using the details you enter. Review the draft and send it in Telegram, or use the direct chat link. --- Source: https://marqius.com/cookies/ Markdown: https://marqius.com/aeo/okf/policies/cookies.md SIMPLE AI LLC · MARQIUS # Cookie Notice Marqius uses security cookies where needed and analytics cookies when you choose to allow them. You can change your analytics choice at any time. Updated 18 November 2026 ## Site delivery and security The site is delivered by Cloudflare. Depending on the security features in use and how a visit is handled, Cloudflare may set cookies such as `cf_clearance` to remember that a security challenge was passed, or `__cf_bm` to support bot detection. These are security cookies, and may not appear on every visit. Cloudflare explains when they can be set and how long they last in its [cookie documentation](https://developers.cloudflare.com/fundamentals/reference/policies-compliances/cloudflare-cookies/). ## Analytics choices We save your choice in browser storage. If you allow analytics, Google Analytics may set cookies such as `_ga` to distinguish visits. [Change your analytics choice](https://marqius.com/cookies/#analytics). Marqius uses these measurements to understand how people use public pages. ## Telegram, X and LinkedIn Sharing and messaging use links that open separate services. Those services may use their own cookies when you visit them. No social widgets or feeds are loaded while you browse Marqius. ## Managing cookies You can review, block or delete cookies using your browser settings. Blocking a security cookie may mean that you see a verification prompt again. See the [Website Privacy Notice](https://marqius.com/privacy/) for more about visitor information, or [contact us](https://marqius.com/contact/) with a question. QUESTIONS & ANSWERS ## Cookie questions ### Does this site use advertising or analytics cookies? Marqius does not use advertising cookies, marketing pixels or cookie-based analytics on this website. Cloudflare may set cookies for site security. ### What changes if I open a share or messaging link? You leave Marqius and visit a separate service. That service applies its own cookie and privacy policies. --- Source: https://marqius.com/docs/licence-api/ Markdown: https://marqius.com/aeo/okf/policies/docs-licence-api.md MARQIUS-WKHTMLTOPDF · DEVELOPER GUIDE # One Client. One trial. One clear way to pay. Register each legal entity your SaaS makes documents for. Every Client gets a 30-day trial, then chooses its own $10/month or $500 lifetime Seat. Registration never charges a card. [Open your licence account →](https://marqius.com/app/billing/)[Read the Licence Agreement](https://marqius.com/wkhtmltopdf/licence-agreement/) 01 · START ## Register a Client A Client is the legal entity in whose name a document is issued. Use one stable, non-personal ID from your own system. The same ID, name and country return the same Client; restoring one never restarts its trial. 1. Sign in and create an API key under [API keys & developer guide](https://marqius.com/app/billing/). It is shown once. Keep it on your server. 2. Send the legal name, two-letter country code and stable ID. 3. Save the returned `id` for checkout and removal. ``` curl -X POST https://marqius.com/api/licence/entities \ -H "Authorization: Bearer $MARQIUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"externalId":"tenant-4711","legalName":"Acme Trading Ltd","country":"US"}' ``` The response includes `trialStartedAt`, `trialEndsAt` and `entitlement`. Timestamps are Unix seconds. A new Client returns HTTP 201; a repeat returns 200. A different entity cannot take over that ID. 02 · PAY WHEN READY ## Choose a plan for that Client Save your billing name and address in [your account](https://marqius.com/app/billing/) first. Read the [Licence Agreement](https://marqius.com/wkhtmltopdf/licence-agreement/), then create Checkout. Use `offerVersion` and `profileRevision` returned by `GET /entities`. Stripe shows the final amount and applicable tax before payment. ``` curl -X POST https://marqius.com/api/licence/entities/CLIENT_ID/checkout \ -H "Authorization: Bearer $MARQIUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"plan":"monthly","accepted":true,"offerVersion":"CURRENT_OFFER_VERSION","profileRevision":2}' ``` Choose `monthly` for $10 per Client per month or `lifetime` for $500 per Client once, upgrades included. The response contains a Stripe `url`. Send the account owner there to pay. A Seat activates only after Stripe confirms payment through its verified webhook. Then call `POST /entities/CLIENT_ID/refresh` and read `entitlement`. A browser return URL is not payment proof. Purchases are per legal entity. Each additional Client chooses its own plan and 30-day trial. Registration and usage reports do not automatically charge a card. 03 · MANAGE ## Keep the Client list accurate `GET /entities` returns up to 100 Clients. Pass `nextCursor` as `?after=...` for the next page. `DELETE /entities/CLIENT_ID` archives a Client and requests cancellation of future monthly renewals at the end of the paid period. Lifetime purchases stay with that entity. Re-registering its original ID restores the record with its original trial and payment history. API keys are account-wide. Revoke an exposed key in the account page. A revoked key stops working immediately. The limit is 100 requests per key per minute. REPORTING CONTRACT ## Daily usage reports The server accepts opaque daily usage snapshots at `POST /usage` and shows the last 30 days at `GET /usage`. The current CLI release does not send them yet. We will connect `--marqius-client`, `MARQIUS_CLIENT` and the web service’s `client` field in the CLI release after this API and UI. A report uses a server-side API key. It supplies a UTC day, stable installation ID, program version, licence label, PDF count and unique 64-character client codes. It never includes document contents, file names or clear Client IDs. Resending an installation/day only updates a snapshot when counts do not go backward. Reports support reconciliation and account visibility; they do not create a paid Seat. Use one API key across a fleet to deduplicate its opaque client codes. ``` { "day":"2026-12-01", "installation":"11111111-1111-4111-a111-111111111111", "version":"0.12.2", "licence":"trial", "pdfs":1834, "clients":2, "client_codes":["<64-character lowercase hex code>",""] } ``` Only hash codes are stored with the report. These are pseudonymous, not guaranteed anonymous when source IDs are predictable. We keep raw daily reports for up to 13 months, then delete them; billing records may be kept longer where required. REFERENCE ## Endpoints | Method | Path after /api/licence | Purpose | | --- | --- | --- | | GET | `/entities` | List entities, offer version, billing profile revision and onboarding choice. | | POST | `/entities` | Register or restore a Client and its one-time trial. | | POST | `/entities/:id/checkout` | Get Stripe Checkout URL for monthly or lifetime. | | POST | `/entities/:id/refresh` | Recheck verified payment and entitlement. | | DELETE | `/entities/:id` | Archive and cancel future monthly renewal. | | POST | `/preferences` | Save the customer-entity onboarding choice. | | GET / POST | `/api-keys` | List or create keys from a signed-in browser session. | | POST | `/api-keys/:id/revoke` | Revoke a key from a signed-in browser session. | | GET / POST | `/usage` | Read summaries or submit a report with an API key. | All requests use HTTPS at `https://marqius.com/api/licence`. Machine requests use `Authorization: Bearer mqk_…`. Browser account actions use the signed-in session. JSON errors include a readable `error`: 400 invalid input, 401 missing authentication, 403 disallowed access, 404 unknown Client, 409 conflict, 429 key limit and 503 temporary service trouble. Retry 429 and 503; resolve 409 before retrying Checkout. Keep API keys on your server. Never put them in browser JavaScript, a public repository or a URL. FAQ ## Questions people ask ### Does registering a Client charge me? No. Each new Client starts a 30-day no-card trial. You choose a plan and complete Stripe Checkout when ready. ### Who counts as a Client? The legal entity in whose name the document is issued. A recipient of that entity’s invoice is not another Client. ### When is a paid Seat active? Only after Stripe confirms payment and the verified entitlement is refreshed. A Checkout URL or browser return is not payment confirmation. ### Can I remove a Client? Yes. Archiving cancels future monthly renewal at the end of the paid period. Restoring the same entity preserves its original trial and purchase history. ## Ready to add your first Client? Start with one legal entity and a 30-day trial. No card is required to register. [Open your account →](https://marqius.com/app/billing/) --- Source: https://marqius.com/engine/ Markdown: https://marqius.com/aeo/okf/products-and-guides/engine.md MARQIUS ENGINE # Turn your source data into PDFs for print. Use Engine when your systems already supply the content. Generate PDFs from HTML, Markdown or web content, with press settings and checks that fit your production workflow. [Evaluate Marqius Engine](https://marqius.com/contact)[Browse Engine Features](https://marqius.com/engine/#product-features) ILLUSTRATIVE CONCEPT BUILT FOR DAILY VOLUME ## Production speed. Print fidelity. [**Keep the batch moving.** Run independent jobs in parallel and reuse the files that haven’t changed.](https://marqius.com/features/parallel-batch-processing/) [**Keep detail on the page.** Set colour, bleed and trim for your press, then check the PDF before release.](https://marqius.com/features/prepress-and-imposition/) MARQIUS FEATURES ## What Marqius Engine does. [All features](https://marqius.com/features/) AI & INTEGRATION ### Generate PDFs from AI workflows Give an MCP-compatible assistant a tool that turns HTML or Markdown into a laid-out PDF. Use Marqius for rendering and keep the source content and review in your workflow. [Explore feature](https://marqius.com/features/ai-pdf-generation/) PRODUCTION SPEED ### Run batches in parallel Keep deadline-driven runs moving: render independent jobs in parallel and reuse cached output when inputs haven’t changed. [Explore feature](https://marqius.com/features/parallel-batch-processing/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) INPUTS & OUTPUTS ### Turn source content into finished files Start with HTML, Markdown or a web address. Prepare a PDF for reading or print, an EPUB 3 edition, or page images for review. [Explore feature](https://marqius.com/features/document-conversion/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) USPS & TRANSACTIONAL PRINT ### USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. [Explore feature](https://marqius.com/features/usps-intelligent-mail/) BOOK PRODUCTION ### Set the interior from a manuscript Choose a book design and trim size, then prepare a manuscript with chapter openers, front matter, running heads and page numbers. [Explore feature](https://marqius.com/features/book-interior-production/) COVERS & EDITIONS ### Prepare the cover around the finished book Lay out the front, spine and back together. Use the interior page count, paper and binding to calculate the spine width for the edition. [Explore feature](https://marqius.com/features/book-cover-and-spine/) DOCUMENT ACCESSIBILITY ### Build accessible documents into the workflow Create tagged PDF/UA-1 output and use the accessibility audit to find issues in the source, including vague link text, missing table headers and unlabelled fields. [Explore feature](https://marqius.com/features/accessible-documents/) SIGNING & PERMISSIONS ### Sign and protect PDFs Apply a digital signature using a certificate, verify signatures, or set PDF permissions when the workflow needs more control over the file. [Explore feature](https://marqius.com/features/pdf-signing-and-permissions/) PRACTICAL EXAMPLES ## See the features in a workflow. [ ### Catalogues and price lists Use product records, photography and ranked specifications to build a consistent edition without redesigning every page. Explore workflow ](https://marqius.com/use-cases/catalogues/)[ ### Long operational reports Give repeat reports clear headings, consistent page numbering and tables that remain readable as source data grows. Explore workflow ](https://marqius.com/use-cases/operational-reports/)[ ### Print production proofs Bring page arrangement, trim marks and space around the page edges into the same conversation as the document layout. Explore workflow ](https://marqius.com/use-cases/production-proofs/) ## Evaluate an output that matters to your team. Bring an anonymised source and the requirements for the finished file. We’ll discuss which settings and checks should be part of the first proof. [Discuss Your Workflow](https://marqius.com/contact) QUESTIONS & ANSWERS ## Questions about Engine ### What can Engine include in a PDF? Engine can compose headings, tables, images, contents, references, page numbers and repeating page furniture from structured content and layout choices. ### What should we discuss before connecting our system? Bring an example of the structured input, the layout it needs and the expected PDF output. Review where generation will run and how the files are handed off. ### What print controls should we evaluate first? Start with the finished page size, bleed, trim marks and the page arrangement requested by your printer. Check those settings in a representative proof. ### What happens when a generation check finds a problem? Marqius reports findings with page details. With strict mode enabled, warnings can stop output so the issue can be reviewed. --- Source: https://marqius.com/features/ Markdown: https://marqius.com/aeo/okf/features/features.md MARQIUS FEATURES # Build the batch. Check the proof. Start with the job you need to finish. Find tools for reusable layouts, parallel runs, press setup, mail preparation and the checks your team makes before release. [Discuss Your Workflow](https://marqius.com/contact)[Browse All Features](https://marqius.com/features/#feature-library) ILLUSTRATIVE CONCEPT [Explore USPS Intelligent Mail](https://marqius.com/features/usps-intelligent-mail/) MARQIUS FEATURES ## Features from source to handoff. AI & INTEGRATION ### Generate PDFs from AI workflows Give an MCP-compatible assistant a tool that turns HTML or Markdown into a laid-out PDF. Use Marqius for rendering and keep the source content and review in your workflow. - The MCP tool accepts HTML or Markdown, a title and a page size. - Use the output for reports, briefs or reading copies. - For application integration, Marqius Engine also provides an HTTP conversion endpoint. [Explore feature](https://marqius.com/features/ai-pdf-generation/) PRODUCTION SPEED ### Run batches in parallel Keep deadline-driven runs moving: render independent jobs in parallel and reuse cached output when inputs haven’t changed. - Run multiple jobs in parallel. - Reuse output for unchanged inputs with caching. - Record elapsed time in the structured job report. [Explore feature](https://marqius.com/features/parallel-batch-processing/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. - Prepare CMYK or named spot inks with the intended press profile. - Use PDF/X-4 or PDF/X-1a output options when the job calls for them. - Arrange pages on sheets, allow for paper thickness and add page barcodes in the bleed for bindery workflows. [Explore feature](https://marqius.com/features/prepress-and-imposition/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. - Check for low-resolution images, insufficient bleed and text too close to the trim. - Check against the printer limits set for the job. - Capture page counts, checksums, colour-page counts and warnings in a report your build can read. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) INPUTS & OUTPUTS ### Turn source content into finished files Start with HTML, Markdown or a web address. Prepare a PDF for reading or print, an EPUB 3 edition, or page images for review. - Choose the content and the output format for the job. - Turn selected pages from a documentation site into a single publication. - Export page images for proofing or thumbnails. [Explore feature](https://marqius.com/features/document-conversion/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. - Set the page size, margins and repeating page elements. - Lay out tables, footnotes, running heads and page cross-references. - Build contents lists, bookmarks, page numbering and fillable PDF fields from HTML. [Explore feature](https://marqius.com/features/page-layout-and-typography/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. - Keep common headers and footers consistent across related documents. - Define where the changing content belongs in the layout. - Proof long records and optional sections before a run. [Explore feature](https://marqius.com/features/reusable-document-templates/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. - Use structured records to populate matching fields. - Proof typical, long and incomplete records before release. - For transactional print, use record boundaries and duplex controls for individual pieces. [Explore feature](https://marqius.com/features/variable-data-personalisation/) WORKFLOW HANDOFF ### Track jobs and route completed files Follow a recurring run from the current data to the finished PDF. Agree where the result should go and what to review when a job needs attention. - Review jobs as they progress through generation. - Retrieve completed files or inspect a job that needs attention. - Set the destination that will receive the finished files. [Explore feature](https://marqius.com/features/job-tracking-and-delivery/) USPS & TRANSACTIONAL PRINT ### USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. - Use duplex placement and PDF/VT output options for record-based print work. - Generate USPS Intelligent Mail or other supported barcode formats. - Use piece and page references to reconcile a run. [Explore feature](https://marqius.com/features/usps-intelligent-mail/) BOOK PRODUCTION ### Set the interior from a manuscript Choose a book design and trim size, then prepare a manuscript with chapter openers, front matter, running heads and page numbers. - Start from one of 20 book designs and 14 trim sizes. - Preview the manuscript with the selected style and trim. - Export a reading or print PDF and an EPUB from the same source. [Explore feature](https://marqius.com/features/book-interior-production/) COVERS & EDITIONS ### Prepare the cover around the finished book Lay out the front, spine and back together. Use the interior page count, paper and binding to calculate the spine width for the edition. - Review the front, back and spine as one sheet. - Use page count, paper and binding to work out spine width. - Review cover and interior at the intended finished size. [Explore feature](https://marqius.com/features/book-cover-and-spine/) DOCUMENT ACCESSIBILITY ### Build accessible documents into the workflow Create tagged PDF/UA-1 output and use the accessibility audit to find issues in the source, including vague link text, missing table headers and unlabelled fields. - Generate tagged PDFs from well-structured source content. - Review the audit for contrast, alternative text and labelling. - Prepare a large-print or EPUB edition when it suits your readers. [Explore feature](https://marqius.com/features/accessible-documents/) SIGNING & PERMISSIONS ### Sign and protect PDFs Apply a digital signature using a certificate, verify signatures, or set PDF permissions when the workflow needs more control over the file. - Use a certificate to sign a PDF and verify the result. - Add certification or trusted timestamps where the signing policy requires them. - Apply AES-256 encryption and set print, copy or editing permissions. [Explore feature](https://marqius.com/features/pdf-signing-and-permissions/) ## Start with a document you already make. Bring an anonymised example and the requirements for the finished file. We’ll discuss the features that fit your workflow. [Discuss Your Workflow](https://marqius.com/contact) QUESTIONS & ANSWERS ## Questions about Marqius features ### What source material can Marqius turn into a document? Use HTML, Markdown or web content to generate output. Choose a reading or print PDF, EPUB 3 or page images to suit the job. ### Where do the speed gains come from? Parallel jobs let you run independent documents together. Caching avoids rendering unchanged inputs again. Use the structured report to review elapsed time for your jobs. ### What should we check before releasing a press file? Review page-level findings, compare the proof with the source and ask the print partner to check the file against its production requirements. ### Can I use Marqius to prepare a recurring mailing? Yes. Marqius Engine prepares separate recipient pieces and can add USPS Intelligent Mail barcodes, inserter marks and payment scan lines when the job calls for them. Confirm the printed proof with your mailing partner. --- Source: https://marqius.com/features/accessible-documents/ Markdown: https://marqius.com/aeo/okf/features/features-accessible-documents.md DOCUMENT ACCESSIBILITY # Build accessible documents into the workflow Create tagged PDF/UA-1 output and use the accessibility audit to find issues in the source, including vague link text, missing table headers and unlabelled fields. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/accessible-documents/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Accessible output starts with a source that communicates its structure. Use clear headings, meaningful link text, table headers and labelled fields. Generate a tagged PDF and review the audit findings alongside a practical reading test. [Explore Marqius Engine](https://marqius.com/engine/) - Generate tagged PDFs from well-structured source content. - Review the audit for contrast, alternative text and labelling. - Prepare a large-print or EPUB edition when it suits your readers. BUSINESS BENEFITS ## What it means for your operation 1. ### Make recurring documents easier to use Preserve heading order, meaningful links and table structure when creating tagged PDFs. Readers who use assistive technology can work with the structure as well as the page. 2. ### Fix a repeating issue at its source If an audit finds an unlabelled field in a shared source, fix it there and regenerate the affected proofs. The correction can carry forward to the next edition. 3. ### Measure issues and real reading tasks Track unresolved audit findings, then test a task such as finding payment instructions with relevant assistive tools. A passing check alone cannot describe the reading experience. ILLUSTRATIVE SCENARIOS ## How industries can use it Healthcare administration ### Make a patient information leaflet easier to navigate Use descriptive headings and explicit link text so readers can find an instruction without relying on its visual position. **In the proof:** Review the reading order and check whether the relevant actions still make sense when read aloud. [Explore healthcare administration](https://marqius.com/industries/healthcare/) Publishing & education ### Prepare a training guide in more than one reading format Structure the manuscript and illustrations, then prepare tagged PDF or EPUB and a large-print edition when appropriate. **In the proof:** Review heading order, alternative text and table labels in the actual files. [Explore publishing & education](https://marqius.com/industries/publishing-and-education/) Financial services & insurance ### Explain a statement with a structured activity table Use explicit column headings and a clear sequence from the summary to the activity detail. **In the proof:** Check that assistive reading presents the dates, descriptions and amounts in context. [Explore financial services & insurance](https://marqius.com/industries/financial-services/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Review the source structure.** Check headings, link and field labels, image alternatives and table headers. 2. **Generate and audit.** Produce tagged output and review audit findings. Fix issues in the source and regenerate the proof. 3. **Read the resulting file.** Assess reading order and key tasks with the assistive tools relevant to the audience. EXPLORE NEXT ## Related workflow guides - [Book interiors and covers](https://marqius.com/use-cases/books/) - [Long operational reports](https://marqius.com/use-cases/operational-reports/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) INPUTS & OUTPUTS ### Turn source content into finished files Start with HTML, Markdown or a web address. Prepare a PDF for reading or print, an EPUB 3 edition, or page images for review. [Explore feature](https://marqius.com/features/document-conversion/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Accessible Documents, PDF/UA-1 and Audits: frequently asked questions ### What does PDF/UA-1 output do? It creates a tagged PDF with a document structure that assistive technology can use. The source and final result still need review. ### Which issues can the accessibility audit find? It can flag issues such as low contrast, missing or weak alternative text, unlabelled fields and tables without headers. ### Is a large-print edition the same as a tagged PDF? No. Large print changes visual presentation; tagged structure helps assistive technology interpret the document. Choose what your audience needs. --- Source: https://marqius.com/features/ai-pdf-generation/ Markdown: https://marqius.com/aeo/okf/features/features-ai-pdf-generation.md AI & INTEGRATION # Generate PDFs from AI workflows Give an MCP-compatible assistant a tool that turns HTML or Markdown into a laid-out PDF. Use Marqius for rendering and keep the source content and review in your workflow. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/ai-pdf-generation/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Give a compatible assistant a defined way to render documents. It passes reviewed HTML or Markdown, a title and a page size to Marqius Engine. Engine lays out the PDF; your workflow determines what is approved to send or print. [Explore Marqius Engine](https://marqius.com/engine/) - The MCP tool accepts HTML or Markdown, a title and a page size. - Use the output for reports, briefs or reading copies. - For application integration, Marqius Engine also provides an HTTP conversion endpoint. BUSINESS BENEFITS ## What it means for your operation 1. ### Make recurring briefs easier to produce Give the assistant a defined rendering step so approved content moves straight into a consistent PDF. The team can spend less time copying text into a page layout. 2. ### Keep control of what gets published Render the same reviewed source through one workflow. Make the PDF a clear sign-off point so reviewers can focus on facts and layout before release. 3. ### Measure the full workflow Time one brief from source to approved PDF. Record layout edits, factual corrections and review time separately, so drafting gains do not hide extra review work. [See the three-step MCP workflow](https://marqius.com/ai/#ai-workflow) ILLUSTRATIVE SCENARIOS ## How industries can use it Manufacturing & distribution ### Turn technical notes into a product brief A product team starts with an approved spec sheet and structured measurements. An assistant drafts the explanatory text, then submits the reviewed HTML to the renderer. **In the proof:** Check the dimensions and units against the source, and inspect the longest specification table. [Explore manufacturing & distribution](https://marqius.com/industries/manufacturing-and-distribution/) Logistics & operations ### Prepare a daily operations brief An assistant organises exceptions and totals from approved inputs into a daily report. Marqius turns the reviewed Markdown into a PDF with the same layout each day. **In the proof:** Check that date ranges, references and counts agree with the operational records. [Explore logistics & operations](https://marqius.com/industries/logistics/) Publishing & education ### Create a training handout An editor provides approved learning content. An assistant structures headings, exercises and references before the page layout is rendered. **In the proof:** Check the citations and make sure the exercise and its instructions appear together. [Explore publishing & education](https://marqius.com/industries/publishing-and-education/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Prepare the source.** Use a reviewed template and an anonymised example. Decide which fields the assistant may fill and what a person must approve. 2. **Render the document.** Call the MCP tool html\_to\_pdf with approved content, a title and a page size. Collect the resulting PDF for review. 3. **Approve the result.** Compare facts to the original source, review the page breaks and decide who can release the finished document. EXPLORE NEXT ## Related workflow guides - [Long operational reports](https://marqius.com/use-cases/operational-reports/) - [Catalogues and price lists](https://marqius.com/use-cases/catalogues/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) INPUTS & OUTPUTS ### Turn source content into finished files Start with HTML, Markdown or a web address. Prepare a PDF for reading or print, an EPUB 3 edition, or page images for review. [Explore feature](https://marqius.com/features/document-conversion/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## AI PDF Generation via MCP: frequently asked questions ### What does the MCP tool accept? A compatible assistant supplies HTML or Markdown, a title and a page size to html\_to\_pdf. Marqius returns a laid-out PDF. ### Who checks the facts in a document drafted by AI? Your team reviews the source content and compares it with the resulting PDF. Rendering does not verify the accuracy of AI-generated content. ### Can a service integrate without an AI agent? Yes. Marqius Engine also provides an HTTP conversion endpoint for applications that submit HTML and receive a PDF. --- Source: https://marqius.com/features/book-cover-and-spine/ Markdown: https://marqius.com/aeo/okf/features/features-book-cover-and-spine.md COVERS & EDITIONS # Prepare the cover around the finished book Lay out the front, spine and back together. Use the interior page count, paper and binding to calculate the spine width for the edition. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/book-cover-and-spine/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow The cover and interior meet at the spine. Use the final page count, paper and binding to calculate the spine width, then review the back, spine and front as one wrap. [Explore Marqius Engine](https://marqius.com/engine/) - Review the front, back and spine as one sheet. - Use page count, paper and binding to work out spine width. - Review cover and interior at the intended finished size. BUSINESS BENEFITS ## What it means for your operation 1. ### Reduce mismatch between cover and interior Use the final page count, paper and binding in the spine calculation. Update the dimensions when the interior changes, before the printer commits to the job. 2. ### Catch alignment issues on a single proof Review back, spine and front together to spot letters or artwork crossing a fold, spine or trim. Give the printer one full-wrap file to check against its template. 3. ### Measure cover correction cycles Record revised proofs and the reason for each correction, such as spine width, stock or trim. Compare the time from interior lock to cover approval. ILLUSTRATIVE SCENARIOS ## How industries can use it Publishing & education ### Prepare the cover of a revised workbook Use the final interior page count for the revised edition and recalculate for the paper and binding in the new order. **In the proof:** Check the wrap against the final job dimensions, including spine lettering and bleed. [Explore publishing & education](https://marqius.com/industries/publishing-and-education/) Manufacturing & distribution ### Cover a reference manual Use a common cover style for manuals in a series, then calculate a separate spine width for each finished interior. **In the proof:** Check the edition label and where the spine title sits on the narrowest volume. [Explore manufacturing & distribution](https://marqius.com/industries/manufacturing-and-distribution/) Retail ### Prepare a cover for a collection book Review a full wrap so imagery and colour sit in the right place across the front, spine and back. **In the proof:** Confirm that important details sit clear of folds, trim and the spine. [Explore retail](https://marqius.com/industries/retail/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Confirm the final interior.** Use the production page count and confirm paper and binding with the printer. 2. **Build the full wrap.** Review the front, back and spine together. Check the placement of lettering and any artwork crossing a fold. 3. **Recheck after changes.** If pagination, stock or binding changes, recalculate the spine and review a fresh cover proof. EXPLORE NEXT ## Related workflow guides - [Book interiors and covers](https://marqius.com/use-cases/books/) - [Print production proofs](https://marqius.com/use-cases/production-proofs/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) BOOK PRODUCTION ### Set the interior from a manuscript Choose a book design and trim size, then prepare a manuscript with chapter openers, front matter, running heads and page numbers. [Explore feature](https://marqius.com/features/book-interior-production/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Book Cover Layout and Spine Width: frequently asked questions ### What changes the spine width? The final page count, paper and binding affect the calculation. Confirm the job’s assumptions with the printer. ### Can I prepare the cover before the interior is final? You can explore the design earlier. Confirm final dimensions and spine type after the interior and stock are known. ### What does a full-wrap proof show? It shows the back, spine and front together so you can inspect alignment, folds and trim across the cover. --- Source: https://marqius.com/features/book-interior-production/ Markdown: https://marqius.com/aeo/okf/features/features-book-interior-production.md BOOK PRODUCTION # Set the interior from a manuscript Choose a book design and trim size, then prepare a manuscript with chapter openers, front matter, running heads and page numbers. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/book-interior-production/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Use the manuscript and a chosen trim as the starting point for a complete book interior. Set the opening pages, chapter flow and running information, then proof the edition in the formats readers will use. [Explore Marqius Engine](https://marqius.com/engine/) - Start from one of 20 book designs and 14 trim sizes. - Preview the manuscript with the selected style and trim. - Export a reading or print PDF and an EPUB from the same source. BUSINESS BENEFITS ## What it means for your operation 1. ### Reuse the manuscript across editions Prepare print and EPUB from one source. Corrections start in the manuscript so your team has fewer separate editions to update and reconcile. 2. ### Make revisions easier to schedule Set the trim, chapter design and recurring page elements early. Focus later reviews on changed sections and their effect on pagination. 3. ### Measure work between manuscript and release Record typesetting time, review cycles and manual corrections for each edition. Include the EPUB’s navigation review as a separate step. ILLUSTRATIVE SCENARIOS ## How industries can use it Publishing & education ### Typeset a teaching edition Use chapter openers, running heads and illustrative content to maintain a recognisable rhythm across units. **In the proof:** Review a typical opening and an exercise-heavy page at the intended trim. [Explore publishing & education](https://marqius.com/industries/publishing-and-education/) Manufacturing & distribution ### Prepare a bound product manual Use a clear contents section, consistent headings and page references for operating and maintenance information. **In the proof:** Verify the procedures and their diagrams still match after pagination. [Explore manufacturing & distribution](https://marqius.com/industries/manufacturing-and-distribution/) Retail ### Create a printed collection book Choose a trim and page style that supports product photography and longer editorial passages. **In the proof:** Proof a photo-led spread and a dense text page separately before finalising the edition. [Explore retail](https://marqius.com/industries/retail/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Select a design and trim.** Choose a book design and trim size from the available options. Mark the manuscript structure and required front matter. 2. **Proof a representative chapter.** Include a chapter opening, a long body section and an illustration, reference or note. 3. **Check each output.** Review the print PDF, reading PDF or EPUB you need for the edition. Confirm navigation in the EPUB and trim in the print proof. EXPLORE NEXT ## Related workflow guides - [Book interiors and covers](https://marqius.com/use-cases/books/) - [Print production proofs](https://marqius.com/use-cases/production-proofs/) - [Workbooks and training manuals](https://marqius.com/use-cases/workbooks-and-training-manuals/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) COVERS & EDITIONS ### Prepare the cover around the finished book Lay out the front, spine and back together. Use the interior page count, paper and binding to calculate the spine width for the edition. [Explore feature](https://marqius.com/features/book-cover-and-spine/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) INPUTS & OUTPUTS ### Turn source content into finished files Start with HTML, Markdown or a web address. Prepare a PDF for reading or print, an EPUB 3 edition, or page images for review. [Explore feature](https://marqius.com/features/document-conversion/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Book Interior Typesetting, Print PDF and EPUB: frequently asked questions ### How many book designs and trim sizes are available? Marqius provides 20 book designs and 14 trim sizes. Start with a representative chapter to see how a combination reads. ### Can a print PDF and EPUB come from the same manuscript? Yes. Use the same source and review each output independently for its reading and distribution requirements. ### When should we lock the trim size? Choose it early for proofing. Confirm it and the final page count before committing to the cover dimensions. --- Source: https://marqius.com/features/document-conversion/ Markdown: https://marqius.com/aeo/okf/features/features-document-conversion.md INPUTS & OUTPUTS # Turn source content into finished files Start with HTML, Markdown or a web address. Prepare a PDF for reading or print, an EPUB 3 edition, or page images for review. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/document-conversion/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Choose a source that is easy to maintain and an output that fits the reader’s task. A PDF keeps a fixed page layout, an EPUB supports digital reading, and page images are useful for proofs and thumbnails. [Explore Marqius Engine](https://marqius.com/engine/) - Choose the content and the output format for the job. - Turn selected pages from a documentation site into a single publication. - Export page images for proofing or thumbnails. BUSINESS BENEFITS ## What it means for your operation 1. ### Reuse work already in your source Prepare a publication from maintained HTML, Markdown or selected web pages. Editors can update the source once for the next set of outputs rather than rekey the text into each edition. 2. ### Give each team the right format Keep the fixed PDF for proofing or print, use EPUB for digital reading and generate page images for a quick review. Each output has a purpose and a clear approval step. 3. ### Measure effort by format Track the time to produce and approve a print file and its digital companions. Include format-specific fixes so the comparison reflects the actual work. ILLUSTRATIVE SCENARIOS ## How industries can use it Manufacturing & distribution ### Turn product documentation into a manual Select the relevant documentation pages and combine them into a single reference for a product or version. **In the proof:** Verify the selected sections, internal links and pages included in the contents. [Explore manufacturing & distribution](https://marqius.com/industries/manufacturing-and-distribution/) Publishing & education ### Prepare print and digital editions Start with a single manuscript, render a fixed-layout PDF and prepare an EPUB for reading devices. **In the proof:** Check chapters, navigation and images separately in both formats. [Explore publishing & education](https://marqius.com/industries/publishing-and-education/) Logistics & operations ### Add page previews to a review workflow Generate an operations PDF from an approved HTML layout and render page images to help reviewers inspect the result. **In the proof:** Use the images for review and keep the PDF as the production document. [Explore logistics & operations](https://marqius.com/industries/logistics/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Pick a source with real structure.** Include headings, a link, a table and an image where they are relevant to the intended document. 2. **Choose the outputs and test each.** Confirm the fixed layout in PDF and review EPUB navigation and page-image crops separately. 3. **Review the final channel.** Confirm which version is for print, digital reading or approval and label it accordingly. EXPLORE NEXT ## Related workflow guides - [Long operational reports](https://marqius.com/use-cases/operational-reports/) - [Book interiors and covers](https://marqius.com/use-cases/books/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) BOOK PRODUCTION ### Set the interior from a manuscript Choose a book design and trim size, then prepare a manuscript with chapter openers, front matter, running heads and page numbers. [Explore feature](https://marqius.com/features/book-interior-production/) AI & INTEGRATION ### Generate PDFs from AI workflows Give an MCP-compatible assistant a tool that turns HTML or Markdown into a laid-out PDF. Use Marqius for rendering and keep the source content and review in your workflow. [Explore feature](https://marqius.com/features/ai-pdf-generation/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## HTML, Markdown and Web to PDF or EPUB: frequently asked questions ### Can I use only part of a website? Yes. Use page selection and filtering to include the pages that belong in the publication. Review the resulting chapter order and links. ### When should I choose a page image rather than a PDF? Use an image when the job needs a thumbnail or visual preview. Keep the PDF when the next step needs the actual document file. ### Should the EPUB be checked independently? Yes. Check navigation, images and reading flow in the intended format instead of using the PDF proof as approval for both. --- Source: https://marqius.com/features/job-tracking-and-delivery/ Markdown: https://marqius.com/aeo/okf/features/features-job-tracking-and-delivery.md WORKFLOW HANDOFF # Track jobs and route completed files Follow a recurring run from the current data to the finished PDF. Agree where the result should go and what to review when a job needs attention. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/job-tracking-and-delivery/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow A generated PDF is only useful when the right person has the right version. Agree which jobs need review, how staff retrieve the result and where the finished file should go. [Explore Marqius Relay](https://marqius.com/relay/) - Review jobs as they progress through generation. - Retrieve completed files or inspect a job that needs attention. - Set the destination that will receive the finished files. BUSINESS BENEFITS ## What it means for your operation 1. ### Reduce time spent locating finished files Use job status and the agreed destination so staff know where the latest completed file belongs and can match it to the run. 2. ### Resolve handoff problems sooner Give jobs that need attention a review path, an owner and a way to identify the affected edition. Staff can focus on the specific job before recreating output. 3. ### Measure the handoff gap Track the time from completed generation to arrival at the agreed destination. Record missed deliveries, misrouted editions and manual follow-ups. ILLUSTRATIVE SCENARIOS ## How industries can use it Logistics & operations ### Keep depot reports separate Tag the job with its depot and reporting date, then use the agreed destination for completed runs. **In the proof:** Review an interrupted job and a completed one. Confirm where each appears and who is expected to act. [Explore logistics & operations](https://marqius.com/industries/logistics/) Retail ### Send the right edition to the right region Keep a region reference through generation and route the approved price lists to the corresponding destination. **In the proof:** Check editions with similar names and verify that their contents and destination agree. [Explore retail](https://marqius.com/industries/retail/) Financial services & insurance ### Separate preparation from release Review representative statements and agree who retrieves or approves the completed output before the next handoff. **In the proof:** Use synthetic records to check how the team handles a job that needs attention. [Explore financial services & insurance](https://marqius.com/industries/financial-services/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Define the job reference.** Choose a reference staff can match to the document, period and destination. 2. **Walk through the main outcomes.** Test a completed run and a job that needs attention. Agree who checks each and when. 3. **Verify the handoff.** Open the file at the intended destination and confirm its edition, contents and job reference. EXPLORE NEXT ## Related workflow guides - [Personalised PDF batches](https://marqius.com/use-cases/batch-pdfs/) - [Personalised customer letters](https://marqius.com/use-cases/customer-letters/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Document Job Tracking and Delivery Routing: frequently asked questions ### What should we test with a receiving system? Verify where a completed file lands and how the receiving team identifies its job or edition. Confirm the exact handoff during evaluation. ### What should happen when a job needs attention? Agree who reviews the job, where they find the relevant output or details, and what they check before release. ### Can we check the route without using customer records? Yes. Use a synthetic batch with the same naming and destination rules before testing with live records. --- Source: https://marqius.com/features/page-layout-and-typography/ Markdown: https://marqius.com/aeo/okf/features/features-page-layout-and-typography.md TYPOGRAPHY & LAYOUT # Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/page-layout-and-typography/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Decide how readers will find their way through the document before deciding how it should look on one page. Use running headings, contents, footnotes and cross-references where they help readers move between sections. [Explore Marqius Engine](https://marqius.com/engine/) - Set the page size, margins and repeating page elements. - Lay out tables, footnotes, running heads and page cross-references. - Build contents lists, bookmarks, page numbering and fillable PDF fields from HTML. BUSINESS BENEFITS ## What it means for your operation 1. ### Spend less time patching changing pages Define tables, running heads and page references in the layout. When records or sections grow, the team can review pagination instead of manually updating every reference. 2. ### Keep dense documents usable Use a consistent hierarchy and continuation information so operators and readers can find a procedure, line item or source reference in a long file. 3. ### Measure manual fixes and findability Count split tables, misplaced notes and broken references that require edits. Ask a reviewer to find two key facts in the longest proof and record where they hesitate. ILLUSTRATIVE SCENARIOS ## How industries can use it Financial services & insurance ### Lay out a long statement Use a clear account summary and let the transaction detail continue across pages. Retain the information that identifies each continuation page. **In the proof:** Proof both a short statement and one with a long transaction table. [Explore financial services & insurance](https://marqius.com/industries/financial-services/) Manufacturing & distribution ### Lay out a technical guide Use structured tables, references and headings so a reader can match a procedure to the right specification. **In the proof:** Check the longest specification, any footnotes and a reference to a later page. [Explore manufacturing & distribution](https://marqius.com/industries/manufacturing-and-distribution/) Publishing & education ### Make training material easy to navigate Group chapters with running heads, page numbers and a contents section. Place notes or references where the reader can find them. **In the proof:** Check the first page of a chapter and a dense page with notes or a table. [Explore publishing & education](https://marqius.com/industries/publishing-and-education/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Set the page structure.** Define trim, margins, heading levels, running information and the order of sections. 2. **Stress-test the layout.** Use a wide table, a long section and a cross-reference that lands several pages away. 3. **Inspect the full proof.** Check contents, page numbers and cross-references after generation, when the page count is known. EXPLORE NEXT ## Related workflow guides - [Long operational reports](https://marqius.com/use-cases/operational-reports/) - [Recurring statements](https://marqius.com/use-cases/statements/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) INPUTS & OUTPUTS ### Turn source content into finished files Start with HTML, Markdown or a web address. Prepare a PDF for reading or print, an EPUB 3 edition, or page images for review. [Explore feature](https://marqius.com/features/document-conversion/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) DOCUMENT ACCESSIBILITY ### Build accessible documents into the workflow Create tagged PDF/UA-1 output and use the accessibility audit to find issues in the source, including vague link text, missing table headers and unlabelled fields. [Explore feature](https://marqius.com/features/accessible-documents/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## PDF Page Layout, Typography and Pagination: frequently asked questions ### What belongs on a continuation page? Include the running information that tells the reader what section or document they are in. Check table headings and page numbering in the proof. ### When should I verify page cross-references? After pagination is final for the proof. A late source edit can move the section that another page points to. ### What should I bring for a layout evaluation? Bring a representative section and the hardest page you expect to publish, such as a long table or a page with several notes. --- Source: https://marqius.com/features/parallel-batch-processing/ Markdown: https://marqius.com/aeo/okf/features/features-parallel-batch-processing.md PRODUCTION SPEED # Run batches in parallel Keep deadline-driven runs moving: render independent jobs in parallel and reuse cached output when inputs haven’t changed. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/parallel-batch-processing/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Independent files can render as parallel jobs. The cache lets an unchanged input reuse a previous result. Use the elapsed time in the job report to see where generation takes time on your own files. [Explore Marqius Engine](https://marqius.com/engine/) - Run multiple jobs in parallel. - Reuse output for unchanged inputs with caching. - Record elapsed time in the structured job report. BUSINESS BENEFITS ## What it means for your operation 1. ### Finish more independent jobs inside the production window Run separate editions or reports together. A large file can render in parallel with smaller ones instead of holding the whole queue. 2. ### Avoid rebuilding work you can reuse Keep unchanged outputs from the previous run when the cache applies. Spend compute and production time on the editions that changed. 3. ### Measure both fresh and repeat runs Track the time until the last approved PDF is ready, cache reuse and output volume. Compare like-for-like batches and log proofing and delivery time separately. ILLUSTRATIVE SCENARIOS ## How industries can use it Retail ### Refresh regional price lists Generate each region’s edition as an independent job. If only one region’s source changes, unchanged inputs can reuse cached results. **In the proof:** Change one region’s prices in a test and confirm only the intended edition is different. [Explore retail](https://marqius.com/industries/retail/) Manufacturing & distribution ### Rebuild a catalogue by product family Prepare a separate file for each product family. Run those files together, then carry forward the unaffected outputs when one family is revised. **In the proof:** Include a dense catalogue section in the test and verify the dated edition labels. [Explore manufacturing & distribution](https://marqius.com/industries/manufacturing-and-distribution/) Logistics & operations ### Produce reports across depots Run separate depot summaries in parallel so a large depot report does not need to finish before other independent documents begin. **In the proof:** Compare a normal depot and one with a long table. Use the report to distinguish render time from time spent reviewing and delivering files. [Explore logistics & operations](https://marqius.com/industries/logistics/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Choose representative files.** Include the shortest, longest and most image-heavy items from the batch. 2. **Compare two builds.** Measure a fresh render and a repeat with caching. Change one input and record which outputs must be regenerated. 3. **Check output as well as elapsed time.** Review document counts, representative PDFs and warnings. Measure delivery separately if it is part of the workflow. EXPLORE NEXT ## Related workflow guides - [Personalised PDF batches](https://marqius.com/use-cases/batch-pdfs/) - [Catalogues and price lists](https://marqius.com/use-cases/catalogues/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) WORKFLOW HANDOFF ### Track jobs and route completed files Follow a recurring run from the current data to the finished PDF. Agree where the result should go and what to review when a job needs attention. [Explore feature](https://marqius.com/features/job-tracking-and-delivery/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Parallel PDF Batch Processing and Caching: frequently asked questions ### What kind of job benefits most from parallel processing? A run made up of independent files, such as regional lists or separate depot reports. A single long document is still one job. ### What happens when a document changes between builds? The changed input should be rendered again. Test your cache with both a changed file and an unchanged file before relying on it in production. ### Do generation timings include physical printing? Use the job report to measure document generation. Paper handling, printing and delivery are separate steps to measure in your workflow. --- Source: https://marqius.com/features/pdf-signing-and-permissions/ Markdown: https://marqius.com/aeo/okf/features/features-pdf-signing-and-permissions.md SIGNING & PERMISSIONS # Sign and protect PDFs Apply a digital signature using a certificate, verify signatures, or set PDF permissions when the workflow needs more control over the file. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/pdf-signing-and-permissions/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Use the controls that fit the document. A certificate-based signature supports verification. Encryption and permissions control supported actions in PDF readers, such as copying, printing or editing. [Explore Marqius Engine](https://marqius.com/engine/) - Use a certificate to sign a PDF and verify the result. - Add certification or trusted timestamps where the signing policy requires them. - Apply AES-256 encryption and set print, copy or editing permissions. BUSINESS BENEFITS ## What it means for your operation 1. ### Make the approved file easier to verify Sign after approval and have the recipient check the signature in its intended reader. This supports a clear handoff for files where the delivered version matters. 2. ### Match document controls to the handoff Choose encryption and permissions for the tasks a recipient needs to do. Test legitimate reading, printing or copying in the intended reader before release. 3. ### Measure verification and support effort Track whether recipients can verify signatures and complete expected tasks. Record failed verifications, permission-related requests and avoidable reissues. ILLUSTRATIVE SCENARIOS ## How industries can use it Financial services & insurance ### Sign a final notice before release Generate the approved notice, apply the signing certificate your organisation uses and verify the signed result. **In the proof:** Open the file in the intended PDF reader and confirm the signature and the final content. [Explore financial services & insurance](https://marqius.com/industries/financial-services/) Manufacturing & distribution ### Issue an approved specification Sign the final specification after reviews, so the receiving team can check the signature on the PDF it receives. **In the proof:** Verify the delivered file and confirm the signed edition is the one the team approved. [Explore manufacturing & distribution](https://marqius.com/industries/manufacturing-and-distribution/) Logistics & operations ### Set permissions for a review document Choose the print, copy or modification permissions that suit the handoff. Test the result with the intended recipient workflow. **In the proof:** Check that legitimate review and printing steps still work in the reader the team uses. [Explore logistics & operations](https://marqius.com/industries/logistics/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Choose the control for the job.** Decide whether the workflow needs a signature, encryption, PDF permissions or a combination. Use your organisation’s approved certificate and policy. 2. **Prepare and check a test PDF.** Apply the settings to a synthetic document. Verify the signature or open the file as an intended recipient. 3. **Confirm the handoff.** Agree who signs, when edits stop and how the receiving team checks the document. EXPLORE NEXT ## Related workflow guides - [Long operational reports](https://marqius.com/use-cases/operational-reports/) - [Recurring statements](https://marqius.com/use-cases/statements/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) WORKFLOW HANDOFF ### Track jobs and route completed files Follow a recurring run from the current data to the finished PDF. Agree where the result should go and what to review when a job needs attention. [Explore feature](https://marqius.com/features/job-tracking-and-delivery/) INPUTS & OUTPUTS ### Turn source content into finished files Start with HTML, Markdown or a web address. Prepare a PDF for reading or print, an EPUB 3 edition, or page images for review. [Explore feature](https://marqius.com/features/document-conversion/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## PDF Signing, Verification and Permissions: frequently asked questions ### What is the difference between a digital signature and PDF permissions? A digital signature supports verification of the signed document. PDF permissions describe actions such as printing, copying or modifying in readers that honour them. ### Can we use our own certificate? Yes. Marqius supports signing with supplied certificates, including PKCS#12 or PEM. Use the certificate and signing policy your organisation requires. ### When should we sign the production PDF? Sign the approved version, after final edits. Verify the signed file before distributing it. --- Source: https://marqius.com/features/prepress-and-imposition/ Markdown: https://marqius.com/aeo/okf/features/features-prepress-and-imposition.md PRINT FIDELITY # Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/prepress-and-imposition/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Prepare the file for the equipment and finishing method the job will use. Work from the intended trim, bleed and press profile, then decide if you need individual pages or pages arranged on a press sheet. [Explore Marqius Engine](https://marqius.com/engine/) - Prepare CMYK or named spot inks with the intended press profile. - Use PDF/X-4 or PDF/X-1a output options when the job calls for them. - Arrange pages on sheets, allow for paper thickness and add page barcodes in the bleed for bindery workflows. BUSINESS BENEFITS ## What it means for your operation 1. ### Reduce avoidable file returns Set trim, bleed and the requested press profile up front. Give the print partner a file it can review against the job specifications before scheduling the run. 2. ### Catch finishing issues while they are easy to fix Proof a folded or imposed sample to surface page order, margins and spine problems before a full run uses paper and press time. 3. ### Measure time to press approval Record how many proofs are returned for file corrections, which settings caused the return, and the time from first handoff to approval. ILLUSTRATIVE SCENARIOS ## How industries can use it Publishing & education ### Prepare a workbook for folding and binding Set the workbook’s trim and bleed, then arrange its pages for the planned booklet or section format. Use creep allowance where folded sheets shift the inner pages. **In the proof:** Fold a sample and verify page order, margins and alignment after trim. [Explore publishing & education](https://marqius.com/industries/publishing-and-education/) Manufacturing & distribution ### Proof a catalogue with edge-to-edge artwork Set the edge treatment for full-page product photography and use the profile supplied for the intended press. **In the proof:** Review the crop, edge coverage and colour with the print partner before committing the run. [Explore manufacturing & distribution](https://marqius.com/industries/manufacturing-and-distribution/) Retail ### Produce a brochure with a named ink Use a named spot ink where the brief calls for it. Choose the PDF/X output option requested for the job. **In the proof:** Ask the print partner to confirm the separation and check the file in its own preflight. [Explore retail](https://marqius.com/industries/retail/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Get the printer’s specifications.** Confirm final size, bleed, colour profile, sheet size, finishing method and the PDF/X option requested. 2. **Make a representative proof.** Include artwork near trim and the densest pages. Prepare an imposed sheet if the job needs one. 3. **Check the exact handoff.** Review the proof with the print partner and agree who will impose the pages, so the file is not imposed twice. EXPLORE NEXT ## Related workflow guides - [Print production proofs](https://marqius.com/use-cases/production-proofs/) - [Book interiors and covers](https://marqius.com/use-cases/books/) - [Workbooks and training manuals](https://marqius.com/use-cases/workbooks-and-training-manuals/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) COVERS & EDITIONS ### Prepare the cover around the finished book Lay out the front, spine and back together. Use the interior page count, paper and binding to calculate the spine width for the edition. [Explore feature](https://marqius.com/features/book-cover-and-spine/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Prepress, PDF/X and Imposition: frequently asked questions ### What does imposition change? It arranges pages on the press sheet for a finishing method such as folding and stitching. Verify the order on a folded proof. ### Which press profile should I use? Ask the print partner for the profile for the intended equipment and paper, and use the profile it specifies for the job. ### Are PDF/X output options a substitute for printer approval? No. Choose the option the printer asks for, then have the intended print partner check the actual file before release. --- Source: https://marqius.com/features/press-checks-and-reliability/ Markdown: https://marqius.com/aeo/okf/features/features-press-checks-and-reliability.md RELIABILITY # Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/press-checks-and-reliability/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Use page-level findings to decide what should be fixed before a PDF is released. Set limits for the job, inspect the report and use strict mode where a warning should stop output. [Explore Marqius Engine](https://marqius.com/engine/) - Check for low-resolution images, insufficient bleed and text too close to the trim. - Check against the printer limits set for the job. - Capture page counts, checksums, colour-page counts and warnings in a report your build can read. BUSINESS BENEFITS ## What it means for your operation 1. ### Find recurring faults earlier Flag issues like low resolution and missing bleed while the source can still be corrected. A page reference gives the operator a place to start. 2. ### Give each shift a consistent release rule Use the same limits and strict mode where warnings should stop the job. Record the result alongside the proof so handoffs are easier to review. 3. ### Measure where faults are caught Record findings before release and issues that still reach the print partner. Compare correction time and repeat findings on the same document family. ILLUSTRATIVE SCENARIOS ## How industries can use it Manufacturing & distribution ### Find weak product images before a run Check a catalogue at the intended image size. The press check can flag a picture that is too low-resolution for the chosen limit. **In the proof:** Replace the source image, rerun the proof and confirm the finding is cleared. [Explore manufacturing & distribution](https://marqius.com/industries/manufacturing-and-distribution/) Publishing & education ### Keep workbook content inside the trim Set the safe margin agreed with the printer, then review warnings for labels or text that sit too close to the edge or spine. **In the proof:** Check a dense page and an illustrated page using the final trim and binding assumptions. [Explore publishing & education](https://marqius.com/industries/publishing-and-education/) Logistics & operations ### Review a recurring document build Read structured results for completed jobs, page counts and warnings. Use strict mode where a failed check should prevent the file from moving on. **In the proof:** Deliberately introduce a known issue in a synthetic proof and verify how the build reports it. [Explore logistics & operations](https://marqius.com/industries/logistics/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Define the limits.** Choose rules for the print job, such as safe margins, image resolution and bleed. 2. **Run a clean and a flawed sample.** Use one normal file and one sample with a known layout or image issue. Review the page references. 3. **Set the release rule.** Record which findings require a correction, which require review and who approves the checked result. EXPLORE NEXT ## Related workflow guides - [Print production proofs](https://marqius.com/use-cases/production-proofs/) - [Long operational reports](https://marqius.com/use-cases/operational-reports/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) DOCUMENT ACCESSIBILITY ### Build accessible documents into the workflow Create tagged PDF/UA-1 output and use the accessibility audit to find issues in the source, including vague link text, missing table headers and unlabelled fields. [Explore feature](https://marqius.com/features/accessible-documents/) WORKFLOW HANDOFF ### Track jobs and route completed files Follow a recurring run from the current data to the finished PDF. Agree where the result should go and what to review when a job needs attention. [Explore feature](https://marqius.com/features/job-tracking-and-delivery/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Print Preflight and Document Reliability: frequently asked questions ### What can a press check flag? Examples include low-resolution images, too little bleed and type too near the trim. Set job-specific limits when your printer supplies them. ### When should we use strict mode? Use it when generation warnings should stop the handoff rather than reach the next stage. Test this with a known fault before enabling it in a recurring build. ### What should the reviewer keep from a run? Keep the finished proof and the relevant reports or findings alongside the job reference so someone can tell what was reviewed. --- Source: https://marqius.com/features/reusable-document-templates/ Markdown: https://marqius.com/aeo/okf/features/features-reusable-document-templates.md REUSABLE DESIGN # Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/reusable-document-templates/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Make the template the home for decisions that should stay consistent: page structure, typography and approved wording. Identify the fields that change so the next run starts with data rather than a layout rebuild. [Explore Marqius Relay](https://marqius.com/relay/) - Keep common headers and footers consistent across related documents. - Define where the changing content belongs in the layout. - Proof long records and optional sections before a run. BUSINESS BENEFITS ## What it means for your operation 1. ### Turn the next run into an update Reuse the approved layout and supply fresh data. Repeat work shifts from rebuilding the page to checking the records and unusual layouts. 2. ### Keep approved wording consistent across variants Reuse a shared header, footer or terms section where documents need the same copy. When it changes, staff know which affected documents to proof. 3. ### Measure effort across editions Time preparation and review for two typical runs. Count manual layout edits and look for outdated wording in the set that moved to the template. ILLUSTRATIVE SCENARIOS ## How industries can use it Healthcare administration ### Keep appointment instructions in the right place Reuse the approved letter structure and contact block, then fill the date, location and optional instructions from synthetic appointment records. **In the proof:** Check that the next action is easy to find even when an address wraps. [Explore healthcare administration](https://marqius.com/industries/healthcare/) Financial services & insurance ### Keep a monthly statement familiar Reuse the statement headings and footer while balances, dates and activity rows change each period. **In the proof:** Proof the due date and summary fields against the source and review continuation pages. [Explore financial services & insurance](https://marqius.com/industries/financial-services/) Retail ### Roll the same price-list design out by region Keep the approved branding and column order while the assortment and prices change by edition. **In the proof:** Verify effective dates and make sure conditions appear with the intended offer. [Explore retail](https://marqius.com/industries/retail/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Identify the fixed sections.** Mark headings, approved wording, contact details and other sections your team wants to reuse. 2. **Map the changing fields.** Include one short record, one long record and one with an optional field left blank. 3. **Review before reuse.** Agree who approves template changes and which representative documents the team checks again after an edit. EXPLORE NEXT ## Related workflow guides - [Personalised customer letters](https://marqius.com/use-cases/customer-letters/) - [Recurring statements](https://marqius.com/use-cases/statements/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) WORKFLOW HANDOFF ### Track jobs and route completed files Follow a recurring run from the current data to the finished PDF. Agree where the result should go and what to review when a job needs attention. [Explore feature](https://marqius.com/features/job-tracking-and-delivery/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Reusable Approved Document Templates: frequently asked questions ### What should be stored in a reusable template? Keep the approved layout and repeated wording there. Use the current source records for information that changes, such as dates and figures. ### Can related templates use the same header or footer? Yes. Reuse shared sections when the wording and layout are meant to stay consistent across a set of documents. ### What should we recheck after a template edit? Review the documents that use the changed section, including the longest records and any output that depended on the old wording. --- Source: https://marqius.com/features/usps-intelligent-mail/ Markdown: https://marqius.com/aeo/okf/features/features-usps-intelligent-mail.md USPS & TRANSACTIONAL PRINT # USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/usps-intelligent-mail/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Prepare the print files for personalised statements, notices and letters. Generate the USPS Intelligent Mail barcode from supplied mailing data, define where each recipient’s piece starts and prepare the job for the printer and mail house. [Explore Marqius Engine](https://marqius.com/engine/) - Use duplex placement and PDF/VT output options for record-based print work. - Generate USPS Intelligent Mail or other supported barcode formats. - Use piece and page references to reconcile a run. MAIL PRODUCTION ## USPS Intelligent Mail barcode (IMb) The Intelligent Mail barcode is the USPS 65-bar format for letters, cards and flats. Marqius generates it from the values supplied for the job. The mailing team provides the correct barcode data and verifies the code and its placement on a finished piece. [USPS PostalPro: Intelligent Mail barcode ↗](https://postalpro.usps.com/mailing/intelligent-mail-barcode/) The piece Define record boundaries and use duplex placement so each recipient’s document starts on its own sheet when the job requires it. The marks Add the Intelligent Mail barcode where it is visible on the finished mailpiece. Use separate inserter marks to identify a piece and the page within it. The handoff Use the run report to reconcile the pieces and choose PDF/VT output when the print workflow calls for it. Confirm the actual file and printed sample with the mail house. BUSINESS BENEFITS ## What it means for your operation 1. ### Keep recipient pieces together at production volume Use record boundaries, duplex placement and inserter marks to organise jobs for households with different page counts. Check that a long statement ends before the next piece begins. 2. ### Pull barcode and envelope issues forward Print, fold and insert a proof before the run. A scan test gives the print and mailing teams a concrete way to find placement issues while the layout can still change. 3. ### Track reconciliation and rework per run Compare source records with print pieces and record sample scan results, rejected pieces and reruns. Use those figures across comparable jobs to judge the benefit. ILLUSTRATIVE SCENARIOS ## How industries can use it Financial services & insurance ### Prepare a monthly statement mailing Turn synthetic account records into separate statements. Give each piece the right barcode data and test records with one, two and several pages. **In the proof:** Scan a finished sample, check that the barcode stays visible in the envelope window and reconcile piece counts. [Explore financial services & insurance](https://marqius.com/industries/financial-services/) Healthcare administration ### Prepare a batch of appointment letters Use a reviewed letter layout and fictional appointment records. Keep the address block and barcode position stable as instructions change. **In the proof:** Fold and insert a test piece. Verify the barcode and address are visible and the right pages stay together. [Explore healthcare administration](https://marqius.com/industries/healthcare/) Retail ### Prepare a recipient-specific offer mailing Use a common letter layout with offer and recipient fields, then prepare separate pieces for the mailing partner. **In the proof:** Confirm the offer version, piece reference and scan result before handing off the run. [Explore retail](https://marqius.com/industries/retail/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Get the specifications from your mail house.** Confirm the mailing service, barcode fields, placement, envelope and print handoff format. Use a synthetic test record. 2. **Proof short and long pieces.** Check that each recipient starts on the intended sheet. Print, fold, insert and scan the sample with the mailing team. 3. **Reconcile before release.** Compare the piece count and references with the source, check inserter marks and review the requested files with the printer or mail house. EXPLORE NEXT ## Related workflow guides - [Recurring statements](https://marqius.com/use-cases/statements/) - [Personalised customer letters](https://marqius.com/use-cases/customer-letters/) - [Personalised PDF batches](https://marqius.com/use-cases/batch-pdfs/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## USPS Intelligent Mail Barcode and Transactional Printing: frequently asked questions ### Does Marqius generate the USPS Intelligent Mail barcode? Yes. It renders the barcode from the values you supply. The mailer supplies the correct mailing data and tests the printed code. ### Is Intelligent Mail a parcel shipping label? No. The Intelligent Mail barcode described here is for USPS letters, cards and flats. It does not book postage or create a parcel shipment. ### Are postal barcodes and inserter marks the same? No. The postal barcode carries mailing information. Inserter marks identify pieces and pages within the production run. ### What should we inspect on a finished mailpiece? Check the barcode scan, its position after folding and inserting, and that the pages belong to the intended recipient. --- Source: https://marqius.com/features/variable-data-personalisation/ Markdown: https://marqius.com/aeo/okf/features/features-variable-data-personalisation.md VARIABLE DATA # Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Discuss Your Workflow](https://marqius.com/contact)[See Industry Examples](https://marqius.com/features/variable-data-personalisation/#industry-examples) ILLUSTRATIVE CONCEPT HOW IT WORKS ## What this changes in your workflow Keep the approved layout and change the information that belongs to each record. Build a first proof around the variations most likely to change how the page reads, such as long names, optional text and multi-page tables. [Explore Marqius Relay](https://marqius.com/relay/) [Explore Marqius Engine](https://marqius.com/engine/) - Use structured records to populate matching fields. - Proof typical, long and incomplete records before release. - For transactional print, use record boundaries and duplex controls for individual pieces. BUSINESS BENEFITS ## What it means for your operation 1. ### Produce many variants from one layout Bring different customers, locations or accounts through the same document flow. Operators spend less time preparing individual layouts for routine variations. 2. ### Make reconciliation part of release Carry a reference from the source record to the output. That gives staff a way to confirm that recipient details and editions belong together before release. 3. ### Measure exceptions per batch Compare record counts, missing fields and the number of PDFs that need manual correction. Check representative long records and empty optional fields before you expand the run. ILLUSTRATIVE SCENARIOS ## How industries can use it Financial services & insurance ### Populate each statement from its own record Use the current reporting date, balances and activity table to render a statement for each synthetic account. **In the proof:** Match the output back to the correct record and reconcile representative totals. [Explore financial services & insurance](https://marqius.com/industries/financial-services/) Healthcare administration ### Prepare appointment letters with optional instructions Use one reviewed layout, then supply the location, date and applicable instructions for a fictional appointment. **In the proof:** Check that missing optional text leaves a readable letter and the key date stays easy to find. [Explore healthcare administration](https://marqius.com/industries/healthcare/) Retail ### Create location-specific documents Populate a common layout with store-specific prices, dates or assortments. **In the proof:** Review the smallest and largest assortments and verify that each offer belongs to the right region. [Explore retail](https://marqius.com/industries/retail/) FIRST-PROOF CHECKLIST ## Test it on a document you already print Start with an anonymised example and record what the finished file must do before the job moves to the next stage. 1. **Define what varies.** Agree on the source field for each value, how dates and amounts are formatted, and which fields may be blank. 2. **Build a small mixed batch.** Include a typical record, an unusually long record and one with missing optional content. 3. **Reconcile input and output.** Compare key facts, file references and destinations before sending the batch to the next stage. EXPLORE NEXT ## Related workflow guides - [Personalised PDF batches](https://marqius.com/use-cases/batch-pdfs/) - [Recurring statements](https://marqius.com/use-cases/statements/) - [Personalised customer letters](https://marqius.com/use-cases/customer-letters/) MARQIUS FEATURES ## Related capabilities [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) USPS & TRANSACTIONAL PRINT ### USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. [Explore feature](https://marqius.com/features/usps-intelligent-mail/) PRODUCTION SPEED ### Run batches in parallel Keep deadline-driven runs moving: render independent jobs in parallel and reuse cached output when inputs haven’t changed. [Explore feature](https://marqius.com/features/parallel-batch-processing/) ## Bring a document your team already makes. Tell us how it’s produced today and what you need from the next run. We’ll discuss a representative proof. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Variable Data and Personalised PDFs: frequently asked questions ### How does personalisation differ from editing the template? The template contains shared design and wording. Personalisation changes the data placed in that template for each recipient or edition. ### Which variation belongs in a first batch test? Include a normal record, a long record, a blank optional field and any value that needs special formatting. ### How do we make sure the right file matches the right record? Carry a record reference through the job, then reconcile selected PDFs and their destinations against the original synthetic records. --- Source: https://marqius.com/industries/ Markdown: https://marqius.com/aeo/okf/industries/industries.md INDUSTRIES # Built around the documents you print. See how different teams turn changing information into consistent pages, from monthly statements to revised product catalogues and learning materials. [Discuss Your Workflow](https://marqius.com/contact)[Explore Industries](https://marqius.com/industries/#industry-list) ILLUSTRATIVE CONCEPT FIND YOUR INDUSTRY ## The documents that keep work moving. [ ### Financial services & insurance Keep account statements, policy schedules and customer notices familiar as balances, coverage details and transaction histories change. Explore industry ](https://marqius.com/industries/financial-services/)[ ### Healthcare administration Build readable appointment letters, administrative notices and information packs around templates your team can review and reuse. Explore industry ](https://marqius.com/industries/healthcare/)[ ### Manufacturing & distribution Turn changing product details, images and specifications into consistent catalogues, price lists and technical sheets. Explore industry ](https://marqius.com/industries/manufacturing-and-distribution/)[ ### Retail Use approved layouts for promotion sheets, seasonal catalogues and local price lists, with room for the details that change by location. Explore industry ](https://marqius.com/industries/retail/)[ ### Logistics & operations Build repeatable layouts for operational summaries, order paperwork and delivery documents that must be easy to scan on paper. Explore industry ](https://marqius.com/industries/logistics/)[ ### Publishing & education Shape book interiors, workbooks and training material with considered typography, a clear chapter structure and a proof sized for the intended edition. Explore industry ](https://marqius.com/industries/publishing-and-education/) MARQIUS FEATURES ## Features across industries [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) USPS & TRANSACTIONAL PRINT ### USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. [Explore feature](https://marqius.com/features/usps-intelligent-mail/) BOOK PRODUCTION ### Set the interior from a manuscript Choose a book design and trim size, then prepare a manuscript with chapter openers, front matter, running heads and page numbers. [Explore feature](https://marqius.com/features/book-interior-production/) ## Show us what your team produces. Bring an anonymised example and tell us what changes between print runs. [Discuss Your Workflow](https://marqius.com/contact) QUESTIONS & ANSWERS ## Finding your industry workflow ### Can I explore more than one industry? Yes. Start with your document rather than your sector if it is a closer fit. Statements, letters, catalogues and reports each have a workflow guide. ### How are these industry examples intended to be used? They illustrate how a familiar document can be structured and proofed. Use them as a starting point for discussing your own inputs and output. ### What if we work in a different industry? Bring an anonymised example and describe what changes between runs. The same document planning process can help clarify what you need. --- Source: https://marqius.com/industries/financial-services/ Markdown: https://marqius.com/aeo/okf/industries/industries-financial-services.md FINANCIAL SERVICES & INSURANCE # Clear statements and policy documents, period after period. Keep account statements, policy schedules and customer notices familiar as balances, coverage details and transaction histories change. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/industries/financial-services/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Keep every statement recognisable Your production window stays fixed even when account histories get longer. A reusable layout holds the summary in place, and a mixed batch proof lets your team check continuation pages and totals before the run. DOCUMENTS TO START WITH ## A practical starting point. - Account statements - Policy schedules - Customer notices ### What this looks like For a monthly statement, keep the account summary and contact details in predictable places. Populate the transaction table from the current period and let longer histories flow onto additional pages. ### Build a first proof 1. Set the approved statement structure, including the summary, activity table, footers and page numbers. 2. Try records with no transactions and with enough activity to span several pages. Check the totals against the source. 3. Review the proof and agree how the finished PDF moves into your existing print or delivery process. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) USPS & TRANSACTIONAL PRINT ### USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. [Explore feature](https://marqius.com/features/usps-intelligent-mail/) SIGNING & PERMISSIONS ### Sign and protect PDFs Apply a digital signature using a certificate, verify signatures, or set PDF permissions when the workflow needs more control over the file. [Explore feature](https://marqius.com/features/pdf-signing-and-permissions/) GO DEEPER ## Related use cases [ ### Recurring statements Keep summaries, activity tables and contact information in a familiar order while figures and transaction histories change each period. Explore workflow ](https://marqius.com/use-cases/statements/)[ ### Personalised customer letters Combine approved wording and recurring brand elements with changing recipient details, dates and instructions. Explore workflow ](https://marqius.com/use-cases/customer-letters/)[ ### Personalised PDF batches Turn structured records into consistent PDFs without manually replacing the names, values or details in each copy. Explore workflow ](https://marqius.com/use-cases/batch-pdfs/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Financial services & insurance: frequently asked questions ### How should we test a multipage statement? Use one short and one long synthetic account history. Check balances against the source, repeated table headings and the order of pages. ### Can we use the same layout for policy renewals? Reuse shared elements such as branding, contact details and page numbering. Give renewal-specific fields and wording their own approved template where needed. ### What should we bring to a first discussion? Bring an anonymised statement or policy schedule, sample field names and your print partner’s requirements. Leave out real account records. --- Source: https://marqius.com/industries/healthcare/ Markdown: https://marqius.com/aeo/okf/industries/industries-healthcare.md HEALTHCARE ADMINISTRATION # Make the next step easy to find in every letter. Build readable appointment letters, administrative notices and information packs around templates your team can review and reuse. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/industries/healthcare/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Keep the next action in sight If you print appointment letters every day, long names and changing instructions can push the information that matters off the first page. Reuse the approved template and proof the longest record before printing. DOCUMENTS TO START WITH ## A practical starting point. - Appointment letters - Administrative notices - Information packs ### What this looks like Start an appointment letter with the date, location and next action. Keep standard preparation and contact details consistent, and reserve space for information that changes by location or appointment. ### Build a first proof 1. Agree on the page order and where recipients should find key instructions. 2. Test synthetic records with long names, different locations and optional instructions. 3. Review readability and page breaks before agreeing on the handoff into your existing delivery process. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) USPS & TRANSACTIONAL PRINT ### USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. [Explore feature](https://marqius.com/features/usps-intelligent-mail/) DOCUMENT ACCESSIBILITY ### Build accessible documents into the workflow Create tagged PDF/UA-1 output and use the accessibility audit to find issues in the source, including vague link text, missing table headers and unlabelled fields. [Explore feature](https://marqius.com/features/accessible-documents/) GO DEEPER ## Related use cases [ ### Personalised customer letters Combine approved wording and recurring brand elements with changing recipient details, dates and instructions. Explore workflow ](https://marqius.com/use-cases/customer-letters/)[ ### Personalised PDF batches Turn structured records into consistent PDFs without manually replacing the names, values or details in each copy. Explore workflow ](https://marqius.com/use-cases/batch-pdfs/)[ ### Workbooks and training manuals Lay out repeatable training editions with clear instructions, usable exercise space and a proof at the final trim size. Explore workflow ](https://marqius.com/use-cases/workbooks-and-training-manuals/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Healthcare administration: frequently asked questions ### What makes a useful appointment-letter proof? Check that readers can find the date, location, instructions and next step quickly, including when text wraps onto an extra line. ### Can shared instructions appear in several letter templates? Use reusable sections for approved contact details or preparation instructions, then review how they fit in each template. ### What information should we share during evaluation? Use fictional or anonymised records and a sample layout. Leave patient information and medical records out of the initial enquiry. --- Source: https://marqius.com/industries/logistics/ Markdown: https://marqius.com/aeo/okf/industries/industries-logistics.md LOGISTICS & OPERATIONS # Keep recurring paperwork clear when the job changes. Build repeatable layouts for operational summaries, order paperwork and delivery documents that must be easy to scan on paper. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/industries/logistics/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Keep the dispatch batch moving Each depot needs its own paperwork, and a late report can delay the next handoff. Generate independent PDFs in parallel where appropriate, then check the job reference and destination before release. DOCUMENTS TO START WITH ## A practical starting point. - Dispatch summaries - Order paperwork - Operational reports ### What this looks like A dispatch summary can put references, dates and destinations first, followed by a consistent table of order details. Short and long jobs use the same visual logic. ### Build a first proof 1. Agree on the fields people need to identify a job at a glance. 2. Test a single order, a long batch and an incomplete record with synthetic data. 3. Review continuation pages and where the PDF should be sent once generated. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) WORKFLOW HANDOFF ### Track jobs and route completed files Follow a recurring run from the current data to the finished PDF. Agree where the result should go and what to review when a job needs attention. [Explore feature](https://marqius.com/features/job-tracking-and-delivery/) PRODUCTION SPEED ### Run batches in parallel Keep deadline-driven runs moving: render independent jobs in parallel and reuse cached output when inputs haven’t changed. [Explore feature](https://marqius.com/features/parallel-batch-processing/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) GO DEEPER ## Related use cases [ ### Personalised customer letters Combine approved wording and recurring brand elements with changing recipient details, dates and instructions. Explore workflow ](https://marqius.com/use-cases/customer-letters/)[ ### Long operational reports Give repeat reports clear headings, consistent page numbering and tables that remain readable as source data grows. Explore workflow ](https://marqius.com/use-cases/operational-reports/)[ ### Personalised PDF batches Turn structured records into consistent PDFs without manually replacing the names, values or details in each copy. Explore workflow ](https://marqius.com/use-cases/batch-pdfs/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Logistics & operations: frequently asked questions ### What should go first on a dispatch summary? Put the information needed to identify the job up front: reference, date and destination. Check the order with the people who use the document. ### What is a useful long-document test? Use a dispatch or order sample with enough rows to cross several pages. Review the headers, totals and job reference on each continuation page. ### How do we review the production handoff? List who receives the PDF, where it lands and who checks jobs that need attention. Walk through the handoff with an anonymised example. --- Source: https://marqius.com/industries/manufacturing-and-distribution/ Markdown: https://marqius.com/aeo/okf/industries/industries-manufacturing-and-distribution.md MANUFACTURING & DISTRIBUTION # Keep product catalogues aligned with the source. Turn changing product details, images and specifications into consistent catalogues, price lists and technical sheets. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/industries/manufacturing-and-distribution/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Stay current without rebuilding the catalogue A new image or specification should not mean reconstructing an entire edition. Keep a consistent product layout, process independent editions in parallel and proof the densest product pages first. DOCUMENTS TO START WITH ## A practical starting point. - Product catalogues - Specification sheets - Distributor price lists ### What this looks like A catalogue revision can reuse the same product layout while new dimensions, images and ranges flow from the updated data. Test dense specifications beside simpler products before approving the run. ### Build a first proof 1. Decide which fields, units and images belong on each product page. 2. Proof short and long product entries, including missing images or optional specification rows. 3. Review version labels, pagination and the print destination before releasing an edition. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) PRODUCTION SPEED ### Run batches in parallel Keep deadline-driven runs moving: render independent jobs in parallel and reuse cached output when inputs haven’t changed. [Explore feature](https://marqius.com/features/parallel-batch-processing/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) GO DEEPER ## Related use cases [ ### Catalogues and price lists Use product records, photography and ranked specifications to build a consistent edition without redesigning every page. Explore workflow ](https://marqius.com/use-cases/catalogues/)[ ### Print production proofs Bring page arrangement, trim marks and space around the page edges into the same conversation as the document layout. Explore workflow ](https://marqius.com/use-cases/production-proofs/)[ ### Workbooks and training manuals Lay out repeatable training editions with clear instructions, usable exercise space and a proof at the final trim size. Explore workflow ](https://marqius.com/use-cases/workbooks-and-training-manuals/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Manufacturing & distribution: frequently asked questions ### Can specification tables continue onto another page? Lay out the table for variable-length content and check repeated headings and the following product’s placement in the proof. ### Can we make a price list from the same product data? Yes. Use the shared product source with a price-list layout designed for scanning codes, prices and units. ### What deserves the closest check on a revised catalogue? Check that images, units and descriptions match the right product code. Then review representative dense pages and any images close to the trim. --- Source: https://marqius.com/industries/publishing-and-education/ Markdown: https://marqius.com/aeo/okf/industries/industries-publishing-and-education.md PUBLISHING & EDUCATION # Bring manuscripts and learning material to the page. Shape book interiors, workbooks and training material with considered typography, a clear chapter structure and a proof sized for the intended edition. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/industries/publishing-and-education/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Keep the edition consistent from cover to cover A late edit can change pagination, chapter breaks and spine width. Work from one manuscript, review a representative section at final trim and confirm the cover dimensions after the page count is set. DOCUMENTS TO START WITH ## A practical starting point. - Books - Workbooks - Learning materials ### What this looks like Set a trim size and typography for a workbook, then proof a chapter opener, a dense reading page and an activity page before preparing the cover and interior. ### Build a first proof 1. Choose the page size, typography and recurring chapter elements. 2. Review a representative chapter with images, notes or exercises. 3. Export the files for review and confirm the printer or publisher’s specifications before release. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) BOOK PRODUCTION ### Set the interior from a manuscript Choose a book design and trim size, then prepare a manuscript with chapter openers, front matter, running heads and page numbers. [Explore feature](https://marqius.com/features/book-interior-production/) COVERS & EDITIONS ### Prepare the cover around the finished book Lay out the front, spine and back together. Use the interior page count, paper and binding to calculate the spine width for the edition. [Explore feature](https://marqius.com/features/book-cover-and-spine/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) DOCUMENT ACCESSIBILITY ### Build accessible documents into the workflow Create tagged PDF/UA-1 output and use the accessibility audit to find issues in the source, including vague link text, missing table headers and unlabelled fields. [Explore feature](https://marqius.com/features/accessible-documents/) GO DEEPER ## Related use cases [ ### Print production proofs Bring page arrangement, trim marks and space around the page edges into the same conversation as the document layout. Explore workflow ](https://marqius.com/use-cases/production-proofs/)[ ### Book interiors and covers Build a publication around its reading rhythm, from chapter openers and typography to illustrations, notes and the cover. Explore workflow ](https://marqius.com/use-cases/books/)[ ### Workbooks and training manuals Lay out repeatable training editions with clear instructions, usable exercise space and a proof at the final trim size. Explore workflow ](https://marqius.com/use-cases/workbooks-and-training-manuals/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Publishing & education: frequently asked questions ### What is the best sample chapter to start with? Choose one that exercises the layout: a chapter opening, body copy, an image or table and any notes or activities you plan to reuse. ### When should we review the cover? Review it once the interior’s page count and trim size are known, so the proportions reflect the intended format. ### Can we prepare different reading formats? Marqius Engine can prepare a print or reading PDF, a cover file or an ebook. Check each export against its intended distributor or print partner. --- Source: https://marqius.com/industries/retail/ Markdown: https://marqius.com/aeo/okf/industries/industries-retail.md RETAIL # Refresh the prices and products without rebuilding the page. Use approved layouts for promotion sheets, seasonal catalogues and local price lists, with room for the details that change by location. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/industries/retail/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Meet the price-change deadline When a promotion changes across regions, run the separate editions together and reuse the layout that stores already know. Check a long assortment and verify prices and dates before the files go to print. DOCUMENTS TO START WITH ## A practical starting point. - Promotional sheets - Seasonal catalogues - Store price lists ### What this looks like For a regional price list, reuse a common layout and populate it with the right assortment, prices and dates for each region. Review a proof for both a small and a full assortment. ### Build a first proof 1. Agree on fixed branding, price hierarchy and where offer conditions appear. 2. Check short and long assortments, sale prices, effective dates and long product names. 3. Review the regional proofs and confirm which edition goes to each print destination. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) USPS & TRANSACTIONAL PRINT ### USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. [Explore feature](https://marqius.com/features/usps-intelligent-mail/) PRODUCTION SPEED ### Run batches in parallel Keep deadline-driven runs moving: render independent jobs in parallel and reuse cached output when inputs haven’t changed. [Explore feature](https://marqius.com/features/parallel-batch-processing/) GO DEEPER ## Related use cases [ ### Catalogues and price lists Use product records, photography and ranked specifications to build a consistent edition without redesigning every page. Explore workflow ](https://marqius.com/use-cases/catalogues/)[ ### Personalised PDF batches Turn structured records into consistent PDFs without manually replacing the names, values or details in each copy. Explore workflow ](https://marqius.com/use-cases/batch-pdfs/)[ ### Print production proofs Bring page arrangement, trim marks and space around the page edges into the same conversation as the document layout. Explore workflow ](https://marqius.com/use-cases/production-proofs/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Retail: frequently asked questions ### How can a regional price list stay consistent? Keep typography and page structure in an approved layout and use regional data to set the assortment and price fields. ### What should we check on a promotional proof? Check price, date, product code and applicable conditions against the source for a few representative offers. ### Can a catalogue and a price list use different layouts? Yes. Choose layouts for each reading task: image-led catalogue pages and more compact, scannable price tables. --- Source: https://marqius.com/privacy/ Markdown: https://marqius.com/aeo/okf/policies/privacy.md SIMPLE AI LLC · MARQIUS # Website Privacy Notice This notice explains how Simple AI LLC handles personal information when you visit marqius.com or contact us about Marqius through this website. It does not describe how a particular product deployment handles documents or customer data. Updated 19 November 2026 ## Who operates the site Simple AI LLC operates the Marqius website. You can reach us using the details below if you have a question or request about your personal information. ## When you browse Cloudflare delivers and protects the site. It may process technical information such as your IP address, browser information and the page you request to deliver content, diagnose service issues and prevent abuse. See [Cloudflare’s privacy policy](https://www.cloudflare.com/privacypolicy/) and our [Cookie Notice](https://marqius.com/cookies/). The site serves its fonts and images from marqius.com. ## Optional analytics If you allow analytics, we use Google Tag Manager to load Google Analytics so we can understand traffic to public Marqius pages. Google receives information such as the page path, browser and device details, and a cookie identifier. You can change your [analytics choices](https://marqius.com/cookies/#analytics) at any time. See [how Google uses information from sites that use its services](https://policies.google.com/technologies/partner-sites). ## Sign in with Google If you sign in with Google, Google shares your account identifier, email address and basic profile. Marqius uses this information to recognise your account and maintain a session. A session cookie keeps you signed in until you sign out or the session expires. See [Google’s privacy policy](https://policies.google.com/privacy). ## Your licence and billing We save your trial dates, selected plan, billing contact and address, payment references, payment status and receipt links in Cloudflare. Stripe processes payments and stores payment methods. Marqius may retain the payment method type, card brand, last four digits and expiry for display; it never stores the full card number or security code. We use these records to manage your licence, renewals, invoices, support and accounting. Billing records may be retained to meet applicable accounting obligations and resolve disputes. Account and billing pages do not run our optional website analytics. See [Stripe’s privacy policy](https://stripe.com/privacy). ## Legal entities and API keys For SaaS accounts, we store the legal entity name, country, the stable external ID you supply, its trial and seat dates, and Stripe payment references. API keys are stored as one-way hashes; the full key is shown only when created. We use these records to distinguish entities, prevent a trial from restarting, manage purchases and cancellations, and answer support requests. The entity API does not receive document contents. Our usage API can store a UTC day, software version, licence label, PDF count and pseudonymous client codes. It does not receive document contents, file names or clear Client IDs. We keep daily reports for up to 13 months and use them to reconcile registered Clients and answer account questions. The currently published CLI does not send reports automatically; a later release will offer that feature. ## When you contact us The enquiry form prepares a Telegram draft using the information you enter, such as your name, work email, organisation and workflow details. The website does not save those fields to a Marqius form database. When you select **Continue to Telegram**, the draft text is included in the link sent to Telegram and may appear in your browser history. We receive the message if you send it in Telegram. You can also open our Telegram chat directly and decide what to share there. We use the enquiries we receive to reply, understand your requirements and discuss possible next steps. Please leave out customer records, confidential documents and sensitive personal information. Use an anonymised example if we ask to see how a document works. Telegram handles your use of its service under [its own privacy policy](https://telegram.org/privacy). ## Sharing a parity run The open wkhtmltopdf parity suite runs on your own computer and sends nothing on its own. If you run its share command and confirm, it sends us a summary of that run: the versions and platform, how many templates there were, each template’s scores without its name, the kinds of difference found and the names of the options you used, with an email address and a note if you add them. It never sends your templates, their file names or paths, or text from them. We save the summary in Cloudflare under a reference number, keep it for twelve months and then delete it. We do not save your IP address with it. We use it to reply to you and to learn which differences matter most. To have a summary deleted sooner, [contact us](https://marqius.com/contact/) and quote its reference. ## How we handle enquiries We process enquiries to respond to requests, take steps you ask us to take before a potential agreement, and manage our business communications. Where applicable, we rely on those purposes or our legitimate interests in operating the site and preventing abuse. We keep enquiries while they are useful for responding and following up, and longer if needed to meet legal obligations or deal with a dispute. Information may be processed in the United States and other countries where our providers operate. We may disclose information if the law requires it. ## Links to other services Some links open Telegram, X or LinkedIn. Those sites apply their own privacy and cookie policies once you open them. The Marqius website uses plain links and does not embed their widgets or feeds. ## Your choices and how to reach us Depending on where you live, you may have rights to access, correct or delete your information, object to or restrict its use, or complain to a privacy regulator. Contact us to make a request. We may need to verify your identity before responding. Simple AI LLC 1209 Mountain Road Pl NE, Ste N Albuquerque, NM 87110 United States [Telegram: +1 505 305 1025](https://t.me/+15053051025) QUESTIONS & ANSWERS ## Privacy questions ### Does the website save my enquiry in a form database? No. The form prepares a Telegram draft. Continuing passes the details to Telegram; we receive the message if you send it there. ### How do I ask about my personal information? Contact Simple AI LLC using the address or chat link in this notice to ask about your information or make a request. --- Source: https://marqius.com/relay/ Markdown: https://marqius.com/aeo/okf/products-and-guides/relay.md MARQIUS RELAY # Keep the approved layout. Run it with fresh data. Use Relay when your team assembles the same statements or notices every run. Reuse the design, generate from the current records, and track where each finished batch needs to go. [Discuss Your Workflow](https://marqius.com/contact)[See Sample Documents](https://marqius.com/sample-documents) ILLUSTRATIVE CONCEPT MARQIUS FEATURES ## What Marqius Relay does. [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) WORKFLOW HANDOFF ### Track jobs and route completed files Follow a recurring run from the current data to the finished PDF. Agree where the result should go and what to review when a job needs attention. [Explore feature](https://marqius.com/features/job-tracking-and-delivery/) PRACTICAL EXAMPLES ## See the features in a workflow. [ ### Recurring statements Keep summaries, activity tables and contact information in a familiar order while figures and transaction histories change each period. Explore workflow ](https://marqius.com/use-cases/statements/)[ ### Personalised customer letters Combine approved wording and recurring brand elements with changing recipient details, dates and instructions. Explore workflow ](https://marqius.com/use-cases/customer-letters/)[ ### Personalised PDF batches Turn structured records into consistent PDFs without manually replacing the names, values or details in each copy. Explore workflow ](https://marqius.com/use-cases/batch-pdfs/) THE WORKFLOW, AT A GLANCE ## From a sample to a repeatable workflow. 01 ### Bring a sample Start with a representative document and the work around it. 02 ### Approve the design Review the layout and identify the information that changes. 03 ### Add fresh information Use your approved design with the next set of details. 04 ### Follow it through Create the document and move it to its destination. ## Bring us the work behind the document. Tell us what your team makes, what changes between runs and where the result needs to go. [Discuss Your Workflow](https://marqius.com/contact) QUESTIONS & ANSWERS ## Questions about Relay ### How does Relay handle a recurring run? Use an approved template, supply the latest records, review the job as it progresses and define where the resulting files go. ### Can multiple templates reuse shared sections? Yes. Reuse approved headers, footers, addresses or terms where the same material appears across several documents. ### How should a team handle a job that needs attention? Agree who reviews the job, which input or layout checks matter and who approves the next handoff. Use a sample run to test that process. --- Source: https://marqius.com/sample-documents/ Markdown: https://marqius.com/aeo/okf/products-and-guides/sample-documents.md SAMPLE DOCUMENTS # See how clear documents look on paper. Explore illustrative approaches to statements, reports, catalogues and books—designed to give information a clearer place on the printed page. [Discuss Your Document](https://marqius.com/contact)[Explore examples](https://marqius.com/sample-documents/#examples) ILLUSTRATIVE CONCEPT THE DETAILS MAKE THE DIFFERENCE ## A closer look at the printed page. Look at how hierarchy, typography, tables, images and page structure come together. ILLUSTRATIVE CONCEPT ### Statement A structured layout for account information, with clear sections and readable tables. ILLUSTRATIVE CONCEPT ### Customer correspondence A considered letter layout that gives changing details room to breathe. ILLUSTRATIVE CONCEPT ### Inspection report Findings, images and observations brought into an organised reading experience. ILLUSTRATIVE CONCEPT ### Product catalogue A product-led layout for images, descriptions and specifications. ILLUSTRATIVE CONCEPT ### Price list A clear, repeatable presentation for changing products and prices. ILLUSTRATIVE CONCEPT ### Book or learning material Thoughtful typography, imagery and a rhythm made for longer reading. These images illustrate design directions. They are not representations of actual customer work or a guarantee of a particular output. ## The most useful example is yours. Share an anonymised document and tell us what you would like to improve. We can discuss the design, the changing information and the route to a finished file. [Discuss Your Document](https://marqius.com/contact) QUESTIONS & ANSWERS ## Using the sample gallery ### Are these examples actual customer files? The gallery contains illustrative designs. It does not show client records or certify a particular production result. ### What should I look at when comparing examples? Look at how each design orders important information, handles tables and images, and helps readers scan the page. ### Can I use our own document to evaluate a layout? Yes. Share an anonymised representative example and describe what should change, what must stay fixed and what the resulting file needs to do. --- Source: https://marqius.com/studio/ Markdown: https://marqius.com/aeo/okf/products-and-guides/studio.md BOOK PRODUCTION # Take your manuscript to print. If you produce books, manuals or course materials, start with one manuscript. Set the trim and type, proof the interior, and prepare the cover, print PDF and ebook with Marqius Engine. [Discuss a Book](https://marqius.com/contact)[See Publishing Features](https://marqius.com/studio/#product-features) ILLUSTRATIVE CONCEPT MARQIUS FEATURES ## What you can do with a manuscript. [All features](https://marqius.com/features/) BOOK PRODUCTION ### Set the interior from a manuscript Choose a book design and trim size, then prepare a manuscript with chapter openers, front matter, running heads and page numbers. [Explore feature](https://marqius.com/features/book-interior-production/) COVERS & EDITIONS ### Prepare the cover around the finished book Lay out the front, spine and back together. Use the interior page count, paper and binding to calculate the spine width for the edition. [Explore feature](https://marqius.com/features/book-cover-and-spine/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) DOCUMENT ACCESSIBILITY ### Build accessible documents into the workflow Create tagged PDF/UA-1 output and use the accessibility audit to find issues in the source, including vague link text, missing table headers and unlabelled fields. [Explore feature](https://marqius.com/features/accessible-documents/) PRACTICAL EXAMPLES ## See the features in a workflow. [ ### Print production proofs Bring page arrangement, trim marks and space around the page edges into the same conversation as the document layout. Explore workflow ](https://marqius.com/use-cases/production-proofs/)[ ### Book interiors and covers Build a publication around its reading rhythm, from chapter openers and typography to illustrations, notes and the cover. Explore workflow ](https://marqius.com/use-cases/books/)[ ### Workbooks and training manuals Lay out repeatable training editions with clear instructions, usable exercise space and a proof at the final trim size. Explore workflow ](https://marqius.com/use-cases/workbooks-and-training-manuals/) ## Start with a chapter. Choose one with the kinds of content your book will use: body text, chapter openings, notes or illustrations. [Discuss Your Workflow](https://marqius.com/contact) QUESTIONS & ANSWERS ## Questions about book production ### Can I start with just a chapter? Yes. Use a representative chapter to choose typography, page dimensions and recurring elements before laying out the rest of the book. ### What can I include in a publication? Build the reading experience around text and images, and add elements such as notes, an introduction, study questions or a glossary as appropriate. ### What output can I prepare? Prepare a PDF for reading or print, a cover file or an ebook. Check the result against the requirements of the publisher, distributor or printer. --- Source: https://marqius.com/terms/ Markdown: https://marqius.com/aeo/okf/policies/terms.md SIMPLE AI LLC · MARQIUS # Website Terms of Use These terms cover access to marqius.com, operated by Simple AI LLC. The site describes Marqius and helps you decide whether to discuss your document workflow with us. Updated 18 November 2026 ## Marqius plans and billing marqius-wkhtmltopdf is licensed per Client: each distinct legal entity or natural person whose own documents it makes. Your own company is one Client; a SaaS customer's separate legal entity is another. Document recipients do not count. The [product Licence Agreement](https://marqius.com/wkhtmltopdf/licence-agreement/) defines this rule and governs software use. Each registered Client may evaluate the software for 30 days without a card or automatic payment. A Monthly Seat is $10 USD per Client per month plus applicable tax; a Lifetime Seat is $500 USD per Client once plus applicable tax, with upgrades included. Additional entities registered through the API choose their own plan and activate only after Stripe confirms their Checkout. Stripe shows the final total before payment. Monthly renewals can be cancelled; access continues through the paid period. Fees are non-refundable except where applicable law requires otherwise. No automatic charges arise merely from registering a Client or counting documents. Contact Simple AI LLC about an incorrect charge or a refund right under applicable law. Nothing here limits rights that cannot legally be excluded. ## Website information and separate agreements Except for the licence and billing offer described above, website descriptions and examples are for information and evaluation and do not promise suitability for a particular workflow. The [marqius-wkhtmltopdf Licence Agreement](https://marqius.com/wkhtmltopdf/licence-agreement/) governs that program. Any other separately agreed product or service is governed by its own agreement. ## Using the site You may browse the site and share links to its pages. Use it lawfully, respect others’ rights and do not attempt to disrupt its operation or gain unauthorised access. Use the contact channels for legitimate enquiries. Only share information you have permission to disclose. ## Content and examples The Marqius name and site materials may be protected by intellectual property rights. Do not present them as your own or use them to imply endorsement. Print images and sample designs are illustrative; they do not represent specific customer work or certify a print result. ## Evaluating print output Requirements depend on your printer, paper, finishing and document content. Review a representative proof and confirm the PDF specifications with the intended print partner before a production run. Availability and suitability for a particular workflow should be confirmed with us. ## External services External services, including Telegram and social sharing sites, are operated separately and apply their own terms. See our [Website Privacy Notice](https://marqius.com/privacy/) for information about enquiries and external links. ## Changes and availability We may update, remove or correct website content and may revise these terms. The date at the top indicates the latest revision. Nothing in these terms limits rights that cannot be limited under applicable law. ## Contact Simple AI LLC 1209 Mountain Road Pl NE, Ste N Albuquerque, NM 87110 United States [Telegram: +1 505 305 1025](https://t.me/+15053051025) QUESTIONS & ANSWERS ## Questions about these terms ### Do these terms cover a product licence? The marqius-wkhtmltopdf Licence Agreement governs that program and its per-Client Seats. These Website Terms also explain the public billing offer. ### Can I send someone a link to a page? Yes. You may share links to pages on the Marqius website. --- Source: https://marqius.com/use-cases/ Markdown: https://marqius.com/aeo/okf/use-cases/use-cases.md USE CASES # Find a workflow for your next run. Follow a document from source data and a reviewed design to a proof you can check and a PDF you can hand off. [Discuss Your Workflow](https://marqius.com/contact)[Browse Workflows](https://marqius.com/use-cases/#workflow-list) ILLUSTRATIVE CONCEPT CHOOSE A WORKFLOW ## What do you need to make? [ ### Recurring statements Keep summaries, activity tables and contact information in a familiar order while figures and transaction histories change each period. Explore workflow ](https://marqius.com/use-cases/statements/)[ ### Personalised customer letters Combine approved wording and recurring brand elements with changing recipient details, dates and instructions. Explore workflow ](https://marqius.com/use-cases/customer-letters/)[ ### Catalogues and price lists Use product records, photography and ranked specifications to build a consistent edition without redesigning every page. Explore workflow ](https://marqius.com/use-cases/catalogues/)[ ### Long operational reports Give repeat reports clear headings, consistent page numbering and tables that remain readable as source data grows. Explore workflow ](https://marqius.com/use-cases/operational-reports/)[ ### Personalised PDF batches Turn structured records into consistent PDFs without manually replacing the names, values or details in each copy. Explore workflow ](https://marqius.com/use-cases/batch-pdfs/)[ ### Print production proofs Bring page arrangement, trim marks and space around the page edges into the same conversation as the document layout. Explore workflow ](https://marqius.com/use-cases/production-proofs/)[ ### Book interiors and covers Build a publication around its reading rhythm, from chapter openers and typography to illustrations, notes and the cover. Explore workflow ](https://marqius.com/use-cases/books/)[ ### Workbooks and training manuals Lay out repeatable training editions with clear instructions, usable exercise space and a proof at the final trim size. Explore workflow ](https://marqius.com/use-cases/workbooks-and-training-manuals/) MARQIUS FEATURES ## Features you can bring into a workflow [All features](https://marqius.com/features/) AI & INTEGRATION ### Generate PDFs from AI workflows Give an MCP-compatible assistant a tool that turns HTML or Markdown into a laid-out PDF. Use Marqius for rendering and keep the source content and review in your workflow. [Explore feature](https://marqius.com/features/ai-pdf-generation/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) ## Let’s look at a real document. Use an anonymised sample to show what the current workflow asks of your team. [Discuss Your Workflow](https://marqius.com/contact) QUESTIONS & ANSWERS ## Choosing a use case ### Where should an operations team begin? Start with the document you repeatedly produce or correct. Compare its input, approval step and handoff with the closest guide. ### What is the difference between a use case and an industry page? An industry page groups the documents a team may produce. A use case follows one kind of document from source information to proof and handoff. ### Can one workflow involve more than one Marqius product? The product you start with depends on the job. Discuss the whole process if you need both document generation and a recurring handoff. --- Source: https://marqius.com/use-cases/batch-pdfs/ Markdown: https://marqius.com/aeo/okf/use-cases/use-cases-batch-pdfs.md PERSONALISED PDF BATCHES # One layout. A different PDF for each record. Turn structured records into consistent PDFs without manually replacing the names, values or details in each copy. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/use-cases/batch-pdfs/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Keep pace when the record count grows Generate each output from the same approved structure, then reconcile the batch against the input. Where jobs are independent, parallel processing helps keep a large file from holding up the rest. SOURCE AND OUTPUT ## A practical starting point. Start with An approved layout and a structured set of sample records with meaningful variations. Produce A set of individual PDFs produced from the same template and ready for an agreed handoff. ### What this looks like Test a short record, the longest record and one with an optional field missing. Each result should still be easy to read and carry the information expected for that record. ### Build a first proof 1. Agree on field names, source ownership and the approved design. 2. Generate a small representative sample and compare the result against the input. 3. Decide how to track jobs that need attention and where finished files should land. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) PRODUCTION SPEED ### Run batches in parallel Keep deadline-driven runs moving: render independent jobs in parallel and reuse cached output when inputs haven’t changed. [Explore feature](https://marqius.com/features/parallel-batch-processing/) WORKFLOW HANDOFF ### Track jobs and route completed files Follow a recurring run from the current data to the finished PDF. Agree where the result should go and what to review when a job needs attention. [Explore feature](https://marqius.com/features/job-tracking-and-delivery/) PRODUCT FIT ## Explore Marqius Relay. [See features and examples](https://marqius.com/relay/) WHERE IT FITS ## Industries that use this workflow [ ### Financial services & insurance Keep account statements, policy schedules and customer notices familiar as balances, coverage details and transaction histories change. Explore industry ](https://marqius.com/industries/financial-services/)[ ### Healthcare administration Build readable appointment letters, administrative notices and information packs around templates your team can review and reuse. Explore industry ](https://marqius.com/industries/healthcare/)[ ### Retail Use approved layouts for promotion sheets, seasonal catalogues and local price lists, with room for the details that change by location. Explore industry ](https://marqius.com/industries/retail/)[ ### Logistics & operations Build repeatable layouts for operational summaries, order paperwork and delivery documents that must be easy to scan on paper. Explore industry ](https://marqius.com/industries/logistics/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Personalised PDF batches: frequently asked questions ### How many examples should we include in a first batch proof? Choose enough to cover a typical record, a long record and a missing optional field. Add any exception specific to your document. ### Can completed files go to our existing process? Relay lets you define a handoff to an agreed destination. Discuss the intended receiving system and workflow before evaluation. ### How should we check for wrong data in a batch? Compare selected output fields to the corresponding source records and verify that the file naming or delivery reference agrees with each record. --- Source: https://marqius.com/use-cases/books/ Markdown: https://marqius.com/aeo/okf/use-cases/use-cases-books.md BOOK INTERIORS AND COVERS # Design the interior. See the book take shape. Build a publication around its reading rhythm, from chapter openers and typography to illustrations, notes and the cover. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/use-cases/books/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Preserve the design through the last edit Carry the chapter styles, page structure and trim from the first proof through production. Review the last interior revision before finalising the cover and spine width. SOURCE AND OUTPUT ## A practical starting point. Start with A representative manuscript chapter, sample images and intended trim size. Produce A book interior for review, with a cover file or digital edition as needed. ### What this looks like Try a normal reading page, an illustrated spread and a section with notes. Once the inside is laid out, review how the cover and page count fit the planned edition. ### Build a first proof 1. Choose a size and typography that suit the reading context. 2. Set the chapter and page structure, then proof the passages with the most variation. 3. Review the cover and export the files for the agreed print or digital channel. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) BOOK PRODUCTION ### Set the interior from a manuscript Choose a book design and trim size, then prepare a manuscript with chapter openers, front matter, running heads and page numbers. [Explore feature](https://marqius.com/features/book-interior-production/) COVERS & EDITIONS ### Prepare the cover around the finished book Lay out the front, spine and back together. Use the interior page count, paper and binding to calculate the spine width for the edition. [Explore feature](https://marqius.com/features/book-cover-and-spine/) DOCUMENT ACCESSIBILITY ### Build accessible documents into the workflow Create tagged PDF/UA-1 output and use the accessibility audit to find issues in the source, including vague link text, missing table headers and unlabelled fields. [Explore feature](https://marqius.com/features/accessible-documents/) PRODUCT FIT ## Explore Marqius Engine. [See features and examples](https://marqius.com/engine/) WHERE IT FITS ## Industries that use this workflow [ ### Publishing & education Shape book interiors, workbooks and training material with considered typography, a clear chapter structure and a proof sized for the intended edition. Explore industry ](https://marqius.com/industries/publishing-and-education/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Book interiors and covers: frequently asked questions ### Can we review the interior before the full manuscript is ready? Yes. Start with one chapter and include examples of the recurring elements you expect in the finished book. ### What should be checked when adding illustrations? Check their placement, captions and page rhythm at the intended size. Include an illustration-heavy page in your proof. ### What files can I prepare for the next review? Prepare a print or reading PDF, a cover file or an ebook, depending on who needs to review it and how it will be distributed. --- Source: https://marqius.com/use-cases/catalogues/ Markdown: https://marqius.com/aeo/okf/use-cases/use-cases-catalogues.md CATALOGUES AND PRICE LISTS # Update the collection. Keep the catalogue recognisable. Use product records, photography and ranked specifications to build a consistent edition without redesigning every page. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/use-cases/catalogues/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Get revised editions to press faster Reuse the product layout when prices, images and specifications change. Process independent editions together and check both the source details and the trim on representative pages. SOURCE AND OUTPUT ## A practical starting point. Start with A product data sample, approved imagery and the intended catalogue or price-list structure. Produce A product-led print PDF or compact price list with consistent typography and layout. ### What this looks like Fit a mix of products into a common layout: a short entry with one photograph and a longer technical entry with a table of variants. ### Build a first proof 1. Map product codes, units, variants and imagery to a consistent structure. 2. Proof representative entries with different lengths and image shapes. 3. Check order, pricing dates, page numbering and trim requirements before release. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) PRODUCT FIT ## Explore Marqius Engine. [See features and examples](https://marqius.com/engine/) WHERE IT FITS ## Industries that use this workflow [ ### Manufacturing & distribution Turn changing product details, images and specifications into consistent catalogues, price lists and technical sheets. Explore industry ](https://marqius.com/industries/manufacturing-and-distribution/)[ ### Retail Use approved layouts for promotion sheets, seasonal catalogues and local price lists, with room for the details that change by location. Explore industry ](https://marqius.com/industries/retail/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Catalogues and price lists: frequently asked questions ### Can images and specification tables be used on the same page? Yes. Test the combination with your actual image ratios and a representative dense table. ### How should we proof a catalogue update? Check a few changed entries against the source, including units, images and prices, then look at page breaks around the longest entries. ### Can one source feed a compact price list? Yes. The price list can use a separate layout with just the fields buyers need to scan. --- Source: https://marqius.com/use-cases/customer-letters/ Markdown: https://marqius.com/aeo/okf/use-cases/use-cases-customer-letters.md PERSONALISED CUSTOMER LETTERS # Make each letter personal and keep the layout familiar. Combine approved wording and recurring brand elements with changing recipient details, dates and instructions. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/use-cases/customer-letters/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Personalise every copy from one layout Keep the approved wording and brand elements in place while new names, dates and instructions flow from each record. Review a long address and a blank optional field before the full run. SOURCE AND OUTPUT ## A practical starting point. Start with A letter template, fictional recipient records and the applicable approved wording. Produce Individual letters with consistent typography and the right data for each recipient. ### What this looks like Use the same organisation heading and footer while the recipient, date and next step change. Test a long address and an optional paragraph before reviewing the first batch. ### Build a first proof 1. Identify the approved sections and variable fields; distinguish required and optional details. 2. Test long recipient names, multi-line addresses and sections that may be absent. 3. Review the resulting letters and confirm who receives the generated files. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) USPS & TRANSACTIONAL PRINT ### USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. [Explore feature](https://marqius.com/features/usps-intelligent-mail/) WORKFLOW HANDOFF ### Track jobs and route completed files Follow a recurring run from the current data to the finished PDF. Agree where the result should go and what to review when a job needs attention. [Explore feature](https://marqius.com/features/job-tracking-and-delivery/) PRODUCT FIT ## Explore Marqius Relay. [See features and examples](https://marqius.com/relay/) WHERE IT FITS ## Industries that use this workflow [ ### Financial services & insurance Keep account statements, policy schedules and customer notices familiar as balances, coverage details and transaction histories change. Explore industry ](https://marqius.com/industries/financial-services/)[ ### Healthcare administration Build readable appointment letters, administrative notices and information packs around templates your team can review and reuse. Explore industry ](https://marqius.com/industries/healthcare/)[ ### Logistics & operations Build repeatable layouts for operational summaries, order paperwork and delivery documents that must be easy to scan on paper. Explore industry ](https://marqius.com/industries/logistics/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Personalised customer letters: frequently asked questions ### Can different letters share a common footer? Yes. Keep approved shared sections reusable, so layout updates can be reviewed across the templates that use them. ### How do we test awkward addresses? Use synthetic addresses that wrap to several lines and check spacing around the opening paragraph and adjacent content. ### Does this page describe a postal delivery service? This workflow prepares personalised documents for your handoff. Bring your existing print or delivery requirements to the evaluation. --- Source: https://marqius.com/use-cases/operational-reports/ Markdown: https://marqius.com/aeo/okf/use-cases/use-cases-operational-reports.md LONG OPERATIONAL REPORTS # Make a long report as readable as the first page. Give repeat reports clear headings, consistent page numbering and tables that remain readable as source data grows. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/use-cases/operational-reports/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Preserve the layout as reports grow Let tables, running headings and references follow the document structure. That gives your reviewers time to check the figures and the hardest pages instead of manually repaginating the report. SOURCE AND OUTPUT ## A practical starting point. Start with A representative report, structured figures and a sample of its tables or images. Produce A laid-out report PDF with repeatable structure and clear continuation pages. ### What this looks like For a periodic inspection report, put the summary up front, then organise findings, photographs and evidence by section. Review how long captions and large tables affect pagination. ### Build a first proof 1. Define the hierarchy for sections, tables, findings and supporting material. 2. Test the densest section and the longest table before approving the layout. 3. Review references, running headings and page order on the complete proof. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) INPUTS & OUTPUTS ### Turn source content into finished files Start with HTML, Markdown or a web address. Prepare a PDF for reading or print, an EPUB 3 edition, or page images for review. [Explore feature](https://marqius.com/features/document-conversion/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) PRODUCT FIT ## Explore Marqius Engine. [See features and examples](https://marqius.com/engine/) WHERE IT FITS ## Industries that use this workflow [ ### Logistics & operations Build repeatable layouts for operational summaries, order paperwork and delivery documents that must be easy to scan on paper. Explore industry ](https://marqius.com/industries/logistics/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Long operational reports: frequently asked questions ### Can a report include page numbers and a contents section? Engine supports structured documents with headings, contents, references and page numbers. Check them after generating a representative report. ### What should we test with a long table? Check continuation headings, units, row boundaries and whether totals still sit with the right table. ### Which report should we use for a first proof? Choose a report that exercises multiple sections, a long table and an image or caption. Use anonymised data. --- Source: https://marqius.com/use-cases/production-proofs/ Markdown: https://marqius.com/aeo/okf/use-cases/use-cases-production-proofs.md PRINT PRODUCTION PROOFS # Review the file before it becomes a print run. Bring page arrangement, trim marks and space around the page edges into the same conversation as the document layout. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/use-cases/production-proofs/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Catch expensive surprises on paper Set the intended bleed, trim and page order in the proof. Check the hardest pages with your print partner while there is still time to correct the source. SOURCE AND OUTPUT ## A practical starting point. Start with A representative PDF or layout and the print partner’s requirements for the intended job. Produce A proof PDF for review against the requirements agreed with the print partner. ### What this looks like A brochure with artwork near the edge needs different attention from a text-only statement. Review the pages at the intended size and verify how artwork sits relative to the cut. ### Build a first proof 1. Ask the printer for the intended page size, edge treatment and finishing requirements. 2. Prepare a proof using representative pages, including any edge-to-edge artwork. 3. Review the result with the print partner before approving the full run. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) PRODUCT FIT ## Explore Marqius Engine. [See features and examples](https://marqius.com/engine/) WHERE IT FITS ## Industries that use this workflow [ ### Manufacturing & distribution Turn changing product details, images and specifications into consistent catalogues, price lists and technical sheets. Explore industry ](https://marqius.com/industries/manufacturing-and-distribution/)[ ### Retail Use approved layouts for promotion sheets, seasonal catalogues and local price lists, with room for the details that change by location. Explore industry ](https://marqius.com/industries/retail/)[ ### Publishing & education Shape book interiors, workbooks and training material with considered typography, a clear chapter structure and a proof sized for the intended edition. Explore industry ](https://marqius.com/industries/publishing-and-education/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Print production proofs: frequently asked questions ### What should I ask a printer to specify? Ask for the finished size, the extra space they need at the edges, and any marks or file settings they expect. ### How do I choose pages for the proof? Choose both a typical page and one most likely to expose a problem, such as edge-to-edge artwork or a dense table. ### Who confirms whether the proof is ready for the run? The intended printer or production team should check the PDF against the job requirements before release. --- Source: https://marqius.com/use-cases/statements/ Markdown: https://marqius.com/aeo/okf/use-cases/use-cases-statements.md RECURRING STATEMENTS # Generate the next statement from the approved layout. Keep summaries, activity tables and contact information in a familiar order while figures and transaction histories change each period. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/use-cases/statements/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Keep statements consistent as records change Short and long account histories can use the same design. Proof both, reconcile totals, and confirm the continuation pages before preparing the next full batch. SOURCE AND OUTPUT ## A practical starting point. Start with An approved statement, synthetic account records and the current reporting period. Produce A batch of personalised statement PDFs with a consistent page structure. ### What this looks like Use one record with a quiet month and one with several pages of activity. The look stays consistent, while the amount of space each record needs can change. ### Build a first proof 1. Identify the template fields and reconcile the statement totals to the source. 2. Check zero-row and long activity tables, including headings on later pages. 3. Agree on what the reviewer should check before handing off the batch. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) REUSABLE DESIGN ### Keep the layout your team approved Reuse approved layouts and shared sections as names, figures, product details and other source information change. [Explore feature](https://marqius.com/features/reusable-document-templates/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) VARIABLE DATA ### Personalise the next set of PDFs Use one approved layout and a fresh set of records to prepare statements, correspondence and other documents that vary from recipient to recipient. [Explore feature](https://marqius.com/features/variable-data-personalisation/) USPS & TRANSACTIONAL PRINT ### USPS Intelligent Mail for transactional print Build a personalised run one mail piece at a time. Generate USPS Intelligent Mail barcodes and add payment scan lines or inserter marks where the workflow requires them. [Explore feature](https://marqius.com/features/usps-intelligent-mail/) PRODUCT FIT ## Explore Marqius Relay. [See features and examples](https://marqius.com/relay/) WHERE IT FITS ## Industries that use this workflow [ ### Financial services & insurance Keep account statements, policy schedules and customer notices familiar as balances, coverage details and transaction histories change. Explore industry ](https://marqius.com/industries/financial-services/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Recurring statements: frequently asked questions ### Can we start with an existing statement PDF? Yes. Use an anonymised copy to identify the approved structure and the information that changes. ### What changes when a statement runs onto a second page? Verify where the table continues, how its headings repeat and which details identify the account and reporting period. ### What should be checked before releasing the batch? Compare representative balances and totals to the source, then check page order and the agreed delivery destination. --- Source: https://marqius.com/use-cases/workbooks-and-training-manuals/ Markdown: https://marqius.com/aeo/okf/use-cases/use-cases-workbooks-and-training-manuals.md WORKBOOKS AND TRAINING MANUALS # Give each lesson room to work on paper. Lay out repeatable training editions with clear instructions, usable exercise space and a proof at the final trim size. [Discuss a Sample](https://marqius.com/contact)[See the Workflow](https://marqius.com/use-cases/workbooks-and-training-manuals/#workflow) ILLUSTRATIVE CONCEPT WHY MARQIUS FITS YOUR WORK ## Make revisions without rebuilding every lesson Use a repeatable design for lesson headings, instructions, diagrams and exercises. When material changes, proof the pages with the longest instructions and make sure there is still room to write. SOURCE AND OUTPUT ## A practical starting point. Start with A representative unit, its diagrams and activities, the intended trim size and the printer’s binding requirements. Produce A print PDF with consistent unit openers, page numbering and exercise layouts. ### What this looks like For a staff training workbook, prove one diagram-heavy lesson and one activity page with long instructions. Confirm the illustration and its caption stay together, and check the writing area at actual size. ### Build a first proof 1. Set the trim and binding margins before laying out a unit. Define styles for instructions, diagrams, captions and response areas. 2. Proof the densest exercise and a lesson that spans several pages. Check that learners can find the right diagram and have room to write. 3. Verify page references after revisions and share a proof at the intended trim with the print partner. MARQIUS FEATURES ## Features for this workflow [All features](https://marqius.com/features/) BOOK PRODUCTION ### Set the interior from a manuscript Choose a book design and trim size, then prepare a manuscript with chapter openers, front matter, running heads and page numbers. [Explore feature](https://marqius.com/features/book-interior-production/) TYPOGRAPHY & LAYOUT ### Lay out long documents with care Control page size and margins, tables, running heads, footnotes and cross-references. Review the longest sections so the document reads as well at the end as it does at the start. [Explore feature](https://marqius.com/features/page-layout-and-typography/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) PRODUCT FIT ## Explore Marqius Engine. [See features and examples](https://marqius.com/engine/) WHERE IT FITS ## Industries that use this workflow [ ### Healthcare administration Build readable appointment letters, administrative notices and information packs around templates your team can review and reuse. Explore industry ](https://marqius.com/industries/healthcare/)[ ### Manufacturing & distribution Turn changing product details, images and specifications into consistent catalogues, price lists and technical sheets. Explore industry ](https://marqius.com/industries/manufacturing-and-distribution/)[ ### Publishing & education Shape book interiors, workbooks and training material with considered typography, a clear chapter structure and a proof sized for the intended edition. Explore industry ](https://marqius.com/industries/publishing-and-education/) ## Bring a document from your next run. Tell us what changes between runs and what the completed file needs to do. Bring an anonymised example to the first discussion. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Workbooks and training manuals: frequently asked questions ### What should I include in the first workbook proof? Choose a unit opener, a dense instructional page and an exercise with space for written answers. Print the proof at the intended size to check margins and usability. ### How can I keep a diagram near the instructions that refer to it? Keep the diagram and caption together in the source layout, then inspect the pagination when a lesson runs long. Check that the instructions still point to the correct figure. ### What changes when we update a training unit? Rebuild the affected edition from the revised source. Check the contents, page references and revised activities, then confirm that any shift in page count still suits the binding. --- Source: https://marqius.com/why-marqius/ Markdown: https://marqius.com/aeo/okf/products-and-guides/why-marqius.md WHY MARQIUS # Built for teams that print every day. Your deadlines come back even when the data changes. Marqius helps your team reuse approved layouts, generate the next batch, and check the files before handing them off to print. [Discuss a Sample](https://marqius.com/contact)[See the Evaluation Plan](https://marqius.com/why-marqius/#proof-plan) ILLUSTRATIVE CONCEPT BUILT FOR DAILY VOLUME ## Production speed. Print fidelity. [**Keep the batch moving.** Run independent jobs in parallel and reuse the files that haven’t changed.](https://marqius.com/features/parallel-batch-processing/) [**Keep detail on the page.** Set colour, bleed and trim for your press, then check the PDF before release.](https://marqius.com/features/prepress-and-imposition/) Illustrative concept · One layout, multiple versions WHY MARQIUS ## Make the first proof earn its place. Marqius fits when your print queue fills with the same kinds of documents and the details change each time. Your team can keep the decisions it has already approved and spend its time checking the records, the exceptions and the final proof. - **Keep the design your team approved.** Reuse the same page structure, typography and shared elements when customer details, figures or product information change. - **Plan for the records that don’t fit neatly.** Try long names, optional sections and tables that run across pages. See how the layout behaves before you commit to the next batch. - **Prepare for the way you actually print.** Review page size, trim marks and output requirements with your production team or print partner. Use their feedback to refine the next proof. MARQIUS FEATURES ## What makes the workflow repeatable. [All features](https://marqius.com/features/) PRODUCTION SPEED ### Run batches in parallel Keep deadline-driven runs moving: render independent jobs in parallel and reuse cached output when inputs haven’t changed. [Explore feature](https://marqius.com/features/parallel-batch-processing/) PRINT FIDELITY ### Control how pages go to press Set the colour profile, bleed, trim marks and sheet layout for the way you print. Inspect the actual finish with your print partner before the full run. [Explore feature](https://marqius.com/features/prepress-and-imposition/) RELIABILITY ### Catch issues before the handoff Use press checks and page-level findings to review the file before release. Strict mode can stop a run when a check raises a warning, so the next step starts with a decision. [Explore feature](https://marqius.com/features/press-checks-and-reliability/) FIND YOUR STARTING POINT ## Choose the tool for the work you do. [ Marqius Engine ### Generate finished PDFs. Turn HTML, Markdown and source data into PDFs with the press settings and checks your production needs. Explore Engine ](https://marqius.com/engine/)[ Marqius Relay ### Keep the next run moving. Bring changing information, approved layouts, job tracking and delivery into one recurring document workflow. Explore Relay ](https://marqius.com/relay/)[ Marqius Studio ### Prepare your next book. Choose a book design and trim size, review the interior, and prepare the cover and edition files. Explore Studio ](https://marqius.com/studio/)[ Marqius wkhtmltopdf ### Drop-in replacement. Keep your code across 14 PDF libraries. Reuse your templates, render a familiar document and compare the PDF before switching. Explore wkhtmltopdf ](https://marqius.com/wkhtmltopdf/) A PRACTICAL EVALUATION ## Bring your hardest example. A simple sample can hide the problems that recur in production. Start with an anonymised document that puts real pressure on the layout. 1. **Pick one document you produce regularly.** Note how often it runs, where the data comes from and what people still do by hand. 2. **Try two contrasting records.** Include a typical one and one with longer text, more rows or missing fields. 3. **Agree on what the proof must pass.** Check that the content is right, the pages break where they should, and your print partner can use the PDF. ## Choose one document. Start there. Tell us how it is made today and what the finished PDF needs to do. We’ll discuss what a representative proof should demonstrate. [Discuss a Sample](https://marqius.com/contact) QUESTIONS & ANSWERS ## Deciding if Marqius fits ### When is an approved template worth reusing? When the document returns often and its data changes more than its design. Statements, notices and price lists are useful starting points. ### What should a proof demonstrate? It should show that the facts match the source, longer content still reads well, and the file meets the requirements you agree with your print partner. ### Which workflow should we evaluate first? Choose a recurring document that takes manual effort today. Include a typical record and the most awkward layout or input you expect the team to handle. --- Source: https://marqius.com/wkhtmltopdf-buy/ Markdown: https://marqius.com/aeo/okf/products-and-guides/wkhtmltopdf-buy.md MARQIUS LICENCE # Start with 30 days on us. No card required. Choose a plan when you’re ready. [Continue with Google](https://marqius.com/app/sign-in/?plan=trial) Already have an account? [Manage your licence](https://marqius.com/app/billing/) ## Monthly **$10**/ Client / month Plus applicable tax. Cancel renewals anytime. One legal entity. Your paid month starts when you purchase. [Choose monthly](https://marqius.com/app/sign-in/?plan=monthly) ## Lifetime UPGRADES INCLUDED **$500**/ Client, once Plus applicable tax. Upgrades included. One legal entity. No renewals. [Choose lifetime](https://marqius.com/app/sign-in/?plan=lifetime) Prices in USD per legal entity. Sign in, review the [Licence Agreement](https://marqius.com/wkhtmltopdf/licence-agreement/), then pay securely with Stripe. Each new SaaS customer entity can use a 30-day trial before paying. QUESTIONS & ANSWERS ## Your licence, explained ### How does the 30-day trial work? Sign in with Google and start your trial from your account. No card is required. The trial ends automatically after 30 days and never becomes a paid subscription unless you choose to purchase. ### What are the paid plans? Each distinct legal entity needs one Seat after its trial. A Monthly Seat is $10 USD per Client per month plus applicable tax and renews until cancelled. A Lifetime Seat is $500 USD per Client once plus applicable tax, with upgrades included. Stripe shows the final total before payment. ### Who counts as a Client? The legal entity whose own documents the Program makes counts as one Client, even across many applications or servers. Each separate SaaS customer legal entity counts separately. People who merely receive its documents do not count. ### How does a SaaS add another Client? Register the legal entity with a stable, non-personal ID through the entity API. Its 30-day trial starts without a charge. Choose a monthly or lifetime plan for that entity; the API returns Stripe Checkout, and the Seat activates only after verified payment. ### Where do I manage payments and receipts? Your account shows your selected plan, billing details and payment history. Stripe handles checkout and payment methods. Use Manage billing to update payment details, find invoices or cancel monthly renewals. ### What happens when I cancel the monthly plan? Cancellation stops future renewals. Your licence remains active through the paid billing period. The account screen shows when that period ends. To purchase lifetime after a monthly plan, cancel renewals and wait for the paid period to end. --- Source: https://marqius.com/wkhtmltopdf/ Markdown: https://marqius.com/aeo/okf/products-and-guides/wkhtmltopdf.md 14 LIBRARIES. YOUR EXISTING CODE. # Drop-in replacement for _wkhtmltopdf._ A drop-in replacement for wkhtmltopdf in 14 PDF libraries. Keep your code and templates with pdfkit, Snappy, wicked\_pdf, Rotativa and more. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) 30-day trial. $10/month or $500 lifetime. wkhtmltopdf (current) Marqius (drop-in) **Proven for real migrations** Drop-in across 14 PDF libraries High-fidelity, production-ready PDFs Simple switching guide KEEP YOUR LIBRARY ## 14 libraries. _One familiar workflow._ Choose the library your app already uses. Open its chapter for the executable setting, commands and an example of the switch. [Get the 14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples) - [Python **python-pdfkit** Open library guide](https://marqius.com/download/developer-manual.pdf#page=7) - [Python **django-wkhtmltopdf** Open library guide](https://marqius.com/download/developer-manual.pdf#page=13) - [PHP **KnpLabs Snappy** Open library guide](https://marqius.com/download/developer-manual.pdf#page=16) - [PHP · Laravel **laravel-snappy** Open library guide](https://marqius.com/download/developer-manual.pdf#page=18) - [PHP **phpwkhtmltopdf** Open library guide](https://marqius.com/download/developer-manual.pdf#page=20) - [PHP · Symfony **KnpSnappyBundle** Open library guide](https://marqius.com/download/developer-manual.pdf#page=23) - [PHP · CakePHP **CakePdf** Open library guide](https://marqius.com/download/developer-manual.pdf#page=26) - [Ruby · Rails **wicked\_pdf** Open library guide](https://marqius.com/download/developer-manual.pdf#page=29) - [Ruby **PDFKit (Ruby)** Open library guide](https://marqius.com/download/developer-manual.pdf#page=31) - [Node.js **wkhtmltopdf for Node** Open library guide](https://marqius.com/download/developer-manual.pdf#page=33) - [Go **go-wkhtmltopdf** Open library guide](https://marqius.com/download/developer-manual.pdf#page=35) - [Java **java-wkhtmltopdf-wrapper** Open library guide](https://marqius.com/download/developer-manual.pdf#page=38) - [Elixir **pdf\_generator** Open library guide](https://marqius.com/download/developer-manual.pdf#page=41) - [.NET **Rotativa.AspNetCore** Open library guide](https://marqius.com/download/developer-manual.pdf#page=44) STACK GUIDES ## Switch in minutes with your stack. Keep your existing code and integrations. Follow a focused guide for your tool. ### pdfkit Replace the executable and keep your pdfkit setup. [View guide](https://marqius.com/wkhtmltopdf/python/) ### Snappy Use Marqius in place of wkhtmltopdf with Snappy. [View guide](https://marqius.com/wkhtmltopdf/laravel-php/) ### wicked\_pdf Switch the binary and keep your Rails configuration. [View guide](https://marqius.com/wkhtmltopdf/rails-ruby/) ### Rotativa Point Rotativa to Marqius and keep your code. [View guide](https://marqius.com/wkhtmltopdf/dotnet/) **Switching manual** Step-by-step instructions, examples, and common notes for pdfkit, Snappy, wicked\_pdf, and Rotativa. [Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf) Replace wkhtmltopdf · 0.9 MB [Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf) 15 libraries · 47 pages [Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf) Ten minutes · 0.6 MB **Verified checksum (SHA-256)** 04 ## How the switch works 1. Install Marqius alongside your current program. The installer preserves an existing wkhtmltopdf unless you explicitly choose to take over. 2. Run your usual HTML through Marqius and compare it with an existing PDF. Check text, fonts, images and page breaks. 3. Point pdfkit, Snappy, wicked\_pdf or Rotativa at the new program, or use the installer’s take-over option. 4. If you need to reverse the switch, the installer can restore the program it replaced. 05 ## What we checked Our internal Linux comparison used 86 documents: 78 print test pages and eight everyday documents. The measured layout match was about 0.99 on a 0–1 scale. Results on your documents may differ, so a trial on your own templates is the decisive check. A terminal comparison report for a sample PDF. 06 ## Why teams are moving The wkhtmltopdf repository is archived, and its maintainer warns against converting HTML you do not trust. Marqius is actively maintained and keeps the command-line workflow familiar. Security-sensitive conversions still need isolation. [Read the security guide](https://marqius.com/wkhtmltopdf/security/)[Read wkhtmltopdf’s status](https://wkhtmltopdf.org/status) READY TO CHECK YOUR OWN PDF? ## Keep the workflow. Check the result. Start with a sample document, compare it, and switch when it meets your standard. [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names belong to their owners and identify the tools discussed in these switching guides. QUESTIONS & ANSWERS ## wkhtmltopdf replacement questions ### Which 14 PDF libraries can I keep? Marqius works in place of the wkhtmltopdf executable with python-pdfkit, django-wkhtmltopdf, KnpLabs Snappy, laravel-snappy, phpwkhtmltopdf, KnpSnappyBundle, CakePdf, wicked\_pdf, PDFKit (Ruby), wkhtmltopdf for Node, go-wkhtmltopdf, java-wkhtmltopdf-wrapper, pdf\_generator, Rotativa.AspNetCore. Each library has a chapter in the developer manual. Keep your templates and calls, configure the executable where needed, and compare a representative PDF before switching. ### Do I have to change my application code? Usually no if your library launches the wkhtmltopdf program. Keep pdfkit, Snappy, wicked\_pdf or Rotativa and change an executable path only if your app pins one. Libraries that load libwkhtmltox directly need a separate integration. ### Will my PDFs look identical? Compare your own documents. Fonts, scripts, page breaks and unusual CSS can produce differences, so render representative PDFs with both programs before switching a production job. ### What about pages that need JavaScript? Test a page that uses your actual scripts. Some JavaScript-heavy pages may need Chrome or Chromium available to the converter; check the resulting charts and content before release. ### Which systems are supported? The current downloads cover Linux x86-64, Linux ARM64 and macOS on Apple silicon. Windows is still in testing. ### Can I go back to my old wkhtmltopdf? Yes. The installer preserves an existing wkhtmltopdf until you explicitly take over. Its uninstall option can restore a program it replaced. ### Is Marqius open source or made by the wkhtmltopdf team? No. Marqius is proprietary software from Simple AI LLC and is independent of the wkhtmltopdf project. ### How does the 30-day trial work? Sign in and start one 30-day trial without a payment card. It does not turn into a paid subscription automatically. The published plans are $10 per month or $500 for a lifetime licence with upgrades included. --- Source: https://marqius.com/wkhtmltopdf/docker/ Markdown: https://marqius.com/aeo/okf/products-and-guides/wkhtmltopdf-docker.md DOCKER · KUBERNETES · CI # Replace wkhtmltopdf _in your image._ Copy the compatible Linux program into your own image and keep your application command. Install the fonts that your document expects. Install fonts Add Marqius Check a PDF [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) [Download switching manual](https://marqius.com/download/replace-wkhtmltopdf.pdf) Dockerfile ``` FROM ubuntu:22.04 # Install fonts your PDFs use RUN apt-get update && \ apt-get install -y curl ca-certificates \ fonts-liberation2 fonts-dejavu-core # Add the compatible program RUN curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` New PDF 1 ### Install fonts A minimal container needs fonts. Add those used by your templates. ``` RUN apt-get install -y fonts-liberation2 fonts-dejavu-core ``` 2 ### Add Marqius Use the verified installer in the image you already operate. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` 3 ### Check a PDF Render and compare an actual document in the same image before rollout. ``` marqius wkhtmltopdf invoice.html new.pdf marqius compare old.pdf new.pdf ``` **Build in your own image** Match your production fonts Keep the previous image tag for rollback **Switching manual** Examples and troubleshooting for Docker and related stacks. [Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf)[14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples) [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) PRACTICAL DETAILS ## What to check before you switch. ### Before changing the base image Install at least one font in a minimal image, then add the same fonts used by your templates. Run an actual invoice, statement or report through both versions, compare the PDFs and keep the previous image tag for rollback. ### Need a service instead? Marqius can also be run as a PDF service. Package and operate it inside your own container and security boundary; review the Engine documentation for that separate deployment. Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides. QUESTIONS & ANSWERS ## Docker questions ### Is there an official public Marqius Docker image? Use the verified Linux download inside your own image today. This site will link an official image if one is published. ### Why must I install fonts in a container? Minimal images may have no fonts at all. Add at least one font and the exact families your templates use, or conversion and text wrapping may fail. ### Can I keep the old image for rollback? Yes. Retain the previous image tag until PDFs from the new image pass your review. ### Does a static executable mean no other configuration is needed? It removes the old Qt and X11 dependency, but your templates may still need fonts, images, network access or browser JavaScript. Test those resources in the final image. --- Source: https://marqius.com/wkhtmltopdf/dotnet/ Markdown: https://marqius.com/aeo/okf/products-and-guides/wkhtmltopdf-dotnet.md .NET · ROTATIVA · ASP.NET CORE # Keep Rotativa. _Replace wkhtmltopdf._ Rotativa starts a wkhtmltopdf program from your application folder. Put the Linux Marqius build there under the same name and keep your ViewAsPdf actions. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) [Download switching manual](https://marqius.com/download/replace-wkhtmltopdf.pdf) wkhtmltopdf (current) Marqius (drop-in) **A simple, drop-in migration** Keep your .NET workflow Install in minutes Compare your own PDFs 1 ### Install Install the compatible program alongside your current wkhtmltopdf. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` 2 ### Rotativa.AspNetCore On Linux, place the installed program in the folder configured for Rotativa and make it executable. ``` cp /usr/local/bin/marqius wwwroot/Rotativa/wkhtmltopdf chmod +x wwwroot/Rotativa/wkhtmltopdf ``` 3 ### Compare output Render a representative document and check the PDF before switching production. ``` marqius wkhtmltopdf invoice.html new.pdf marqius compare old.pdf new.pdf ``` **Switching manual** Examples and troubleshooting for .NET and related stacks. [Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf)[14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples) [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) PRACTICAL DETAILS ## What to check before you switch. ### Wkhtmltopdf.NetCore Put the compatible executable in the folder named in your registration. ``` builder.Services.AddWkhtmltopdf("wkhtmltopdf"); ``` ### Libraries that load libwkhtmltox DinkToPdf and WkHtmlToPdf-DotNet load a native library rather than running wkhtmltopdf. This executable cannot replace that library. Windows builds also remain in testing. Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides. QUESTIONS & ANSWERS ## .NET questions ### Does Rotativa work on Windows App Service? The current compatible executable release is for Linux and Apple silicon macOS. Windows support is still being tested; use a Linux host for the current Rotativa path. ### Can DinkToPdf use this executable? No. DinkToPdf loads libwkhtmltox directly instead of starting wkhtmltopdf, so it needs a separate library integration. ### Do Razor views and headers change? Rotativa can keep the same Razor views and command-line options. Test headers, footers and page breaks on your actual documents. ### Can I use it on Azure or AWS? Use a supported Linux runtime, put the executable where the application expects it, install the required fonts and verify a PDF in that environment. --- Source: https://marqius.com/wkhtmltopdf/download/ Markdown: https://marqius.com/aeo/okf/products-and-guides/wkhtmltopdf-download.md DOWNLOAD AND INSTALL # Install Marqius. _Check your PDFs._ Keep your existing tools. Verify the result on your own documents before switching production. ## 1 Install ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` ## 2 Check your PDF ``` marqius wkhtmltopdf invoice.html new.pdf marqius compare old.pdf new.pdf ``` **Terminal** **Platform:** macOS arm64 **Downloaded:** Marqius 0.11.0 **SHA-256 verified:** OK **Installed:** Marqius beside wkhtmltopdf Next: check a document you already use. **SHA-256 verified** Existing wkhtmltopdf stays until you choose to take over Undo when ready ## Install, then check your PDF. 1 ### Install beside your current program The installer detects your platform, verifies the checksum and preserves an existing wkhtmltopdf. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` 2 ### Compare a real document Generate a PDF from your HTML, then compare it with a known-good copy before switching production. ``` marqius wkhtmltopdf invoice.html new.pdf marqius compare old.pdf new.pdf ``` **Switching manual** Install, verify, switch and undo with one practical guide. [Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf)[14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples) [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) PRACTICAL DETAILS ## What to check before you switch. ### Choose when to take over An existing wkhtmltopdf remains untouched by default. Use --take-over only after testing. --rollback restores a prior Marqius version; --uninstall restores a program the installer replaced. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash -s -- --take-over ``` ### Install on Debian with APT Use the signed Marqius APT repository on Debian 12 or 13 for amd64 and arm64. The package installs its own executable so you can check it beside your current converter. [Signed APT installation](https://marqius.com/blog/install-marqius-with-apt/) ### Optional Python and PHP helpers These MIT-licensed helpers configure an already installed executable. Use the Python wheel URL with pip install, or add https://marqius.com/download/helpers as a Composer repository and require marqius/marqius-snappy:0.1.1. [Python helper wheel](https://marqius.com/download/helpers/marqius_pdfkit-0.1.0-py3-none-any.whl)[Composer helper source ZIP](https://marqius.com/download/helpers/marqius-snappy-0.1.1.zip) ### Where it runs The current release includes Linux x86-64, Linux ARM64 and macOS Apple silicon. Windows is still in testing. Docker users can copy the Linux program into their own image. [Docker guide](https://marqius.com/wkhtmltopdf/docker/)[Switching manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf) Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides. QUESTIONS & ANSWERS ## Download questions ### Will the installer replace my existing wkhtmltopdf without asking? No. It installs Marqius and leaves an existing wkhtmltopdf alone. Use --take-over only after you have checked your PDFs. ### How is the program download verified? The installer checks the SHA-256 digest of the downloaded executable against the checksum published beside that release before installing it. ### Does Marqius need Qt, X11 or a browser? Basic rendering does not require Qt or X11. Pages that depend on browser JavaScript may need Chrome or Chromium; test the pages your application actually uses. ### Which fonts will my PDFs use? The converter uses fonts available to its environment. Add the fonts your documents expect, especially in minimal Docker images, and compare text wrapping before switching. ### Can I install it beside the original and undo an update? Yes. Keep the original in place while testing. The installer supports --rollback for the prior Marqius version and --uninstall to restore a wkhtmltopdf it replaced. ### Can I download it for Windows? The current release has Linux x86-64, Linux ARM64 and Apple silicon macOS builds. A Windows build is still in testing. --- Source: https://marqius.com/wkhtmltopdf/laravel-php/ Markdown: https://marqius.com/aeo/okf/products-and-guides/wkhtmltopdf-laravel-php.md PHP · LARAVEL · SNAPPY # Keep Snappy. _Replace wkhtmltopdf._ Snappy and laravel-snappy hand HTML to a wkhtmltopdf executable. Set its path to Marqius and keep your Blade views and PDF calls. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) [Download switching manual](https://marqius.com/download/replace-wkhtmltopdf.pdf) wkhtmltopdf (current) Marqius (Snappy) **A simple, drop-in migration** Keep your PHP & Laravel workflow Install in minutes Compare your own PDFs 1 ### Install Install the compatible program alongside your current wkhtmltopdf. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` 2 ### Laravel configuration Set the two binary paths in the environment used by config/snappy.php. ``` WKHTML_PDF_BINARY=/usr/local/bin/wkhtmltopdf WKHTML_IMG_BINARY=/usr/local/bin/wkhtmltoimage ``` 3 ### Compare output Render a representative document and check the PDF before switching production. ``` marqius wkhtmltopdf invoice.html new.pdf marqius compare old.pdf new.pdf ``` **Switching manual** Examples and troubleshooting for PHP & Laravel and related stacks. [Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf)[14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples) [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) PRACTICAL DETAILS ## What to check before you switch. ### Symfony and plain PHP ``` use Knp\Snappy\Pdf; $snappy = new Pdf('/usr/local/bin/wkhtmltopdf'); $snappy->generateFromHtml($html, '/tmp/invoice.pdf', ['page-size' => 'A4']); ``` ### Compare your output Keep a known invoice or report PDF. Generate it with Marqius, then compare it before moving the server path. Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides. QUESTIONS & ANSWERS ## PHP & Laravel questions ### Do my Blade views change? No when Snappy runs a wkhtmltopdf executable. Keep your views and PDF calls, then point the binary setting to the installed program. ### Do header and footer views still work? Test your existing header and footer HTML with the familiar command options and inspect the rendered pages before rollout. ### What if Snappy reports exit code 1? Read the converter output for the missing input, asset or other specific error. Reproduce it with one HTML document before changing a production worker. ### What about Browsershot or spatie/laravel-pdf? Those can use a browser-based rendering path rather than the wkhtmltopdf executable. Check the package integration before replacing a binary. --- Source: https://marqius.com/wkhtmltopdf/licence-agreement/ Markdown: https://marqius.com/aeo/okf/policies/wkhtmltopdf-licence-agreement.md Product licence · Simple AI LLC # marqius-wkhtmltopdf Licence Agreement The terms for using the program for your own documents or for the legal entities your SaaS serves. Effective 18 November 2026 · Version 2026-11-18-usd-tax-client-seat-v1 **One Client, one Seat** A Client is the legal entity whose documents you make. Each has its own 30-day evaluation period; paid use starts only after its Stripe Checkout. [View plans](https://marqius.com/wkhtmltopdf-buy/). Effective 18 November 2026. Version `2026-11-18-usd-tax-client-seat-v1`. This Agreement is between Simple AI LLC, 1209 Mountain Road Pl NE, Ste N, Albuquerque, NM 87110, United States ("Marqius", "we", "us"), and the person or legal entity that downloads, installs, runs, or purchases marqius-wkhtmltopdf ("you"). If you act for an organisation, you confirm that you can accept this Agreement for it. By downloading, installing, running, or purchasing the Program, you accept these terms. If you do not agree, do not use or purchase it. ## 1\. Definitions | Term | Meaning | | --- | --- | | Program | marqius-wkhtmltopdf, its installers, container images, documentation, and updates. | | Client | The legal entity or natural person whose own documents the Program makes, as section 2 explains. | | Seat | A paid licence to make documents for one Client. | | Monthly Seat | A Seat billed at $10 USD per month, plus applicable tax, until cancelled. | | Lifetime Seat | A Seat paid for once at $500 USD, plus applicable tax, for the life of the Program, with upgrades included. | | Account | Your authenticated Marqius account, including the legal entities you register through the Marqius API. | | Unlicensed Notice | A notice on output identifying an unlicensed copy, where supported by the Program version in use. | This Agreement covers only marqius-wkhtmltopdf. Marqius Engine, Studio, Relay, and any other Marqius products have their own offers and terms. ## 2\. Counting Clients **One Client is one distinct legal entity, regardless of how many applications, servers, departments, brands, or sites it uses.** If the Program makes your organisation's own documents, your organisation is a Client. Each separate subsidiary, affiliate, or customer legal entity whose own documents you make is another Client. A natural person whose documents are issued in that person's own name is one Client. A document belongs to the entity in whose name it is issued, sent, or kept. A person or company that merely receives a Client's invoice, letter, or statement is not an additional Client. Development and testing for an existing Client do not add a Client. | Situation | Clients needing Seats after trial | | --- | --- | | Your company makes its own invoices in several applications and on many servers | 1 | | A group of three separate companies makes each company's own documents | 3 | | A SaaS platform makes invoices for 300 customer companies and its own company | 301 | | A company sends statements to 5,000 consumers on its own letterhead | 1 | Your SaaS platform must use a stable, non-personal external ID for each Client it registers through the API. Register a Client before using the Program for its documents. Do not group different legal entities under one ID or register the same entity under new IDs to restart its trial. If the correct count is unclear, contact hello@marqius.com before purchase; our written answer governs that case. ## 3\. Licence grant For each Client with an active Seat, we grant you a non-exclusive, non-transferable, non-sublicensable right to install and run the Program on any number of your computers, servers, virtual machines, and containers to make that Client's documents. Production, development, and testing are included. You may make reasonable backup and deployment copies. One Seat is tied to one Client. It does not move to another legal entity when the first Client is removed from your Account. You may operate document generation for a Client as its service provider, but you may not distribute the Program for another party to install or resell it without a separate written agreement. We and our licensors retain ownership of the Program and all rights not expressly granted here. ## 4\. Thirty-day evaluation Your Account offers a 30-day, no-card trial. A SaaS customer may register each distinct Client through the API for its own 30-day evaluation period, beginning when that Client is first registered. Re-registering or restoring the same Client never restarts its trial. Some Program releases also keep a local trial clock; that local clock does not extend an Account or Client trial. A trial is for evaluation and does not create a payment obligation or automatically become a paid Seat. You can choose and pay for a Monthly or Lifetime Seat at any time. When a Client's trial ends without a paid Seat, continued production use for that Client is not licensed. The Program may continue making PDFs and add the Unlicensed Notice where that release supports it; it does not stop processing solely because the trial ended. The absence of a notice in an older release does not extend the trial or grant a Seat. ## 5\. Buying and managing Seats The public online prices on this Agreement's effective date are $10 USD per Client per month for a Monthly Seat and $500 USD per Client once for a Lifetime Seat, plus applicable tax. Stripe shows the final amount before you pay. Each additional Client selects its own plan. An API request to register a Client starts only its trial; it does not charge you. The API returns a Stripe Checkout URL when you choose a paid plan for that Client. **A Seat activates only after Stripe confirms payment**, not when the checkout URL is created or the browser returns to Marqius. Monthly Seats renew each month until cancelled. If you remove a Client through the API, we archive its record and request cancellation of future monthly renewals at the end of its paid period. Access already paid for remains through that period. A Lifetime Seat has no renewals, remains associated with its original Client, and cannot be transferred to a different Client. Restoring an archived Client does not restart its trial or erase its payment history. Fees already paid are non-refundable except where applicable law requires otherwise. No refund or credit is due for a partial month, an unused Seat, a downgrade, or cancellation. Contact hello@marqius.com about an incorrect charge or a refund right under applicable law. A refund, chargeback, or disputed payment may suspend or end the corresponding Seat while it is unresolved. We may change the Monthly price for future renewals with at least 30 days' notice. The price of a Lifetime Seat already paid for does not change. If you do not accept a future Monthly price, cancel before it takes effect. ## 6\. Account API and licence keys An API key authorises actions for your Account. Keep it confidential, store it as a secret, and revoke it promptly if it is exposed. You are responsible for Client registrations and purchases initiated with your keys. The API stores the Client's legal name, country, stable external ID, trial and Seat status, and Stripe payment references. It does not need your document contents to register or bill a Client. Where a Program release requires a signed Licence Key, a paid Seat and any remaining trial may be represented by a key that the Program checks offline. Until self-service key delivery is available, contact hello@marqius.com from the Account's billing email to request a key for an eligible Client. Some earlier releases do not check keys. You must register each Client through the API and complete its Checkout before its trial ends if you want uninterrupted licensed use. **Client identification and daily reports.** From the first Program release that supports them, you must identify the Client for each PDF with `--marqius-client`, `MARQIUS_CLIENT`, or the web service's `client` field. A PDF without a Client ID counts as your own organisation. Use a stable, non-personal ID, not a name or email address. That release will keep daily PDF counts and one-way Client codes on your installation and send a daily usage report to Marqius using an Account API key. The report contains the day, Program version, licence label, PDF count, count of distinct Clients, and opaque codes of those Client IDs. It does not contain PDF contents, document file names, or Client IDs in clear text. These codes are pseudonymous and may be linkable to a Client if an ID is predictable; our [Privacy Notice](https://marqius.com/privacy/) explains retention and use. The reporting release will queue a report if it cannot reach Marqius. After seven days without an accepted report, it may add an Unlicensed Notice to PDFs until reporting resumes, while continuing to make PDFs. Contact hello@marqius.com before using it in a network that cannot report. **The currently published release does not yet implement these CLI fields or automatic reports.** The server already provides the reporting API and Account view; reporting becomes an obligation only when you run a release that supports it. Usage reports help reconcile registered Clients and Seats. They do not automatically register a legal entity, start a paid Seat, or charge a card; each additional Client still receives its own trial and chooses a plan through the API. ## 7\. Restrictions You must not modify or redistribute the Program, defeat a licence check or Unlicensed Notice, falsify a Client identity or Seat count, or use one Client's Seat for another. You must not reverse engineer, decompile, or disassemble the Program, except to the extent mandatory law gives you a right that cannot be excluded. You must not use the Program unlawfully or remove its proprietary notices. If you need interoperability information that mandatory law entitles you to obtain, contact hello@marqius.com first. We may suspend or terminate rights for a material breach under section 9. These restrictions do not limit rights that applicable law makes non-waivable. ## 8\. Updates and support A paid Monthly Seat includes Program updates released during its paid period. A Lifetime Seat includes future Program versions for the life of the Program. We provide support by email at hello@marqius.com without a guaranteed response time. You are responsible for checking your own documents and output before using them in production. ## 9\. Term and termination This Agreement begins when you first download, install, run, or purchase the Program. You may stop using it at any time and cancel Monthly renewals through your Account. Cancellation takes effect at the end of the paid period. We may suspend or terminate a Seat for a material breach that you do not cure within 30 days after written notice. We may act immediately for deliberate licence circumvention, fraud, or unlawful use. When a Seat ends, your right to use the Program for that Client's production documents ends, even if an offline copy technically continues to run. Fees already accrued remain payable. Sections concerning ownership, restrictions, payment obligations, warranty disclaimers, liability, and dispute resolution survive termination. ## 10\. Disclaimer of warranties THE PROGRAM IS PROVIDED "AS IS" AND "AS AVAILABLE" TO THE MAXIMUM EXTENT PERMITTED BY LAW. WE DISCLAIM IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, ACCURACY, AND NON-INFRINGEMENT. We do not promise that the Program will be uninterrupted, error-free, or suitable for a particular legal, tax, or regulatory purpose. You must review each document and the resulting PDF before relying on it or sending it. ## 11\. Limitation of liability To the maximum extent permitted by law, our total liability arising from this Agreement or the Program is limited to the Fees you actually paid us under this Agreement. We are not liable for lost profit, revenue, business, goodwill, or data, or for indirect, incidental, special, consequential, exemplary, or punitive damages, even if advised they might occur. Nothing here excludes liability that cannot legally be excluded. ## 12\. Indemnification To the extent permitted by law, you will defend and indemnify us against third-party claims arising from your documents, your use of the Program, or your material breach of this Agreement, provided we promptly notify you of the claim, let you control its defence and settlement, and reasonably assist at your expense. You may not settle a claim in a way that imposes an obligation on us without our written consent. ## 13\. General We handle Account and payment information as described in our [Privacy Notice](https://marqius.com/privacy/). We may notify you at your Account email or on marqius.com. You can send legal notices to hello@marqius.com and our address above. We may amend this Agreement; material changes take effect at least 30 days after notice, and you may cancel Monthly Seats before they take effect. The Website Terms of Use and any written Client-count clarification under section 2 form part of this Agreement. If a term is unenforceable, the rest remains in effect. Neither party waives a right by delaying its exercise. New Mexico law governs this Agreement, without regard to conflict-of-law rules. Courts in Bernalillo County, New Mexico have jurisdiction, except where mandatory law gives you another venue. You may not transfer your Seat or this Agreement without our written consent. We may transfer this Agreement in connection with a merger, acquisition, or sale of our business. Questions about this Agreement or a Client count: hello@marqius.com. ## Questions about these terms ### Who needs a Seat? Each distinct legal entity whose own documents the Program makes needs a Seat after its trial. Recipients of its documents do not count. ### Does adding a Client charge us immediately? No. Registering a legal entity through the API begins its 30-day trial. A paid Seat begins only after you choose its plan and complete Stripe Checkout. ### What happens when we remove a Client? Its record is archived and future monthly renewals are cancelled at the end of the paid period. A lifetime Seat stays tied to that entity. --- Source: https://marqius.com/wkhtmltopdf/node-go/ Markdown: https://marqius.com/aeo/okf/products-and-guides/wkhtmltopdf-node-go.md NODE.JS · GO · COMMAND-LINE WRAPPERS # Keep the wrapper. _Swap the program._ If your package starts wkhtmltopdf, Marqius can take that executable name. Keep the calling code and test its output stream and error handling. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) [Download switching manual](https://marqius.com/download/replace-wkhtmltopdf.pdf) wkhtmltopdf (current) Marqius (drop-in) **A simple, drop-in migration** Keep your Node & Go workflow Install in minutes Compare your own PDFs 1 ### Install Install the compatible program alongside your current wkhtmltopdf. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` 2 ### Node.js Keep your calling code and update the executable path. ``` const wkhtmltopdf = require("wkhtmltopdf"); wkhtmltopdf.command = "/usr/local/bin/wkhtmltopdf"; wkhtmltopdf(html, { pageSize: "A4" }).pipe(fs.createWriteStream("report.pdf")); ``` 3 ### Compare output Render a representative document and check the PDF before switching production. ``` marqius wkhtmltopdf invoice.html new.pdf marqius compare old.pdf new.pdf ``` **Switching manual** Examples and troubleshooting for Node & Go and related stacks. [Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf)[14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples) [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) PRACTICAL DETAILS ## What to check before you switch. ### Go ``` wkhtmltopdf.SetPath("/usr/local/bin/wkhtmltopdf") pdfg, _ := wkhtmltopdf.NewPDFGenerator() pdfg.AddPage(wkhtmltopdf.NewPageReader(strings.NewReader(html))) _ = pdfg.Create() ``` ### Other command-line callers Exercise standard input/output, page options and the exit status your application expects. Use the switching manual as a checklist. Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides. QUESTIONS & ANSWERS ## Node & Go questions ### Do I have to replace my Node.js or Go package? Usually no if it starts a wkhtmltopdf executable. Configure the path to the installed compatible program where your package pins one. ### Can my application stream the PDF? Test the standard input and output path your application already uses, including error handling and exit status. ### Will the same command work in CI? Install the correct Linux build and the fonts used by your templates in the runner, then render and compare a test document. ### What if a package loads libwkhtmltox instead of a program? An executable replacement will not work for a direct native-library binding. That integration needs a separate adapter. --- Source: https://marqius.com/wkhtmltopdf/python/ Markdown: https://marqius.com/aeo/okf/products-and-guides/wkhtmltopdf-python.md PYTHON · PDFKIT · DJANGO · IMGKIT # Keep pdfkit. _Replace wkhtmltopdf._ pdfkit runs the wkhtmltopdf command. Install Marqius under that name, and your Python PDF calls can stay the same. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) [Download switching manual](https://marqius.com/download/replace-wkhtmltopdf.pdf) wkhtmltopdf (current) Marqius (drop-in) **A simple, drop-in migration** Keep your Python workflow Install in minutes Compare your own PDFs 1 ### Install Install the compatible program alongside your current wkhtmltopdf. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` 2 ### pdfkit If wkhtmltopdf is already on PATH, leave your code as it is. If you configured an absolute path, point it to the installed program. ``` import pdfkit pdfkit.from_file("invoice.html", "invoice.pdf", options={"page-size": "A4"}) config = pdfkit.configuration(wkhtmltopdf="/usr/local/bin/wkhtmltopdf") ``` 3 ### Compare output Render a representative document and check the PDF before switching production. ``` marqius wkhtmltopdf invoice.html new.pdf marqius compare old.pdf new.pdf ``` **Switching manual** Examples and troubleshooting for Python and related stacks. [Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf)[14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples) [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) PRACTICAL DETAILS ## What to check before you switch. ### Django and imgkit Set WKHTMLTOPDF\_CMD only when the executable is outside PATH. imgkit can use the wkhtmltoimage name installed beside it. ``` WKHTMLTOPDF_CMD = "/usr/local/bin/wkhtmltopdf" config = imgkit.config(wkhtmltoimage="/usr/local/bin/wkhtmltoimage") ``` ### Check before changing production ``` marqius wkhtmltopdf invoice.html new.pdf marqius compare old.pdf new.pdf ``` Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides. QUESTIONS & ANSWERS ## Python questions ### Do I uninstall wkhtmltopdf before trying Marqius? No. Install Marqius beside it, run a representative HTML document and compare the PDF first. Change the executable path when you are ready. ### Does it work in Flask, FastAPI and Celery jobs? A job that launches pdfkit can point to the compatible executable in the same way as a web process. Make sure the worker environment has the program and fonts, then test its actual job. ### What if pdfkit says no executable was found? Put the installed wkhtmltopdf-compatible executable on PATH or set its absolute path with pdfkit.configuration. ### Can django-wkhtmltopdf and imgkit use it? They launch wkhtmltopdf or wkhtmltoimage commands. Configure the installed executable path where your deployment needs an explicit path, and test both PDF and image output. ### Will my CSS or flex layouts render the same? Check a representative template. Marqius and the old WebKit engine can lay out some CSS differently; comparison on your documents is the safest way to decide. --- Source: https://marqius.com/wkhtmltopdf/rails-ruby/ Markdown: https://marqius.com/aeo/okf/products-and-guides/wkhtmltopdf-rails-ruby.md RUBY · RAILS · WICKED\_PDF · PDFKIT # Keep wicked\_pdf. _Replace wkhtmltopdf._ Keep your render pdf calls and views. Give wicked\_pdf or PDFKit the new executable path, then compare a representative PDF. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) [Download switching manual](https://marqius.com/download/replace-wkhtmltopdf.pdf) wkhtmltopdf (current) Marqius (drop-in) **A simple, drop-in migration** Keep your Ruby & Rails workflow Install in minutes Compare your own PDFs 1 ### Install Install the compatible program alongside your current wkhtmltopdf. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` 2 ### wicked\_pdf If your Gemfile includes wkhtmltopdf-binary, remove it before setting the new executable path. ``` WickedPdf.config = { exe_path: "/usr/local/bin/wkhtmltopdf" } render pdf: "invoice", template: "invoices/show", layout: "pdf" ``` 3 ### Compare output Render a representative document and check the PDF before switching production. ``` marqius wkhtmltopdf invoice.html new.pdf marqius compare old.pdf new.pdf ``` **Switching manual** Examples and troubleshooting for Ruby & Rails and related stacks. [Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf)[14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples) [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) PRACTICAL DETAILS ## What to check before you switch. ### PDFKit ``` PDFKit.configure { |config| config.wkhtmltopdf = "/usr/local/bin/wkhtmltopdf" } ``` ### Check your pages Exercise headers, footers, tables of contents and longer text. Compare the rendered pages before you switch a production job. Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides. QUESTIONS & ANSWERS ## Ruby & Rails questions ### Do wicked\_pdf helpers and Rails views still work? The helpers prepare HTML in Rails. Keep them and configure wicked\_pdf to run the installed wkhtmltopdf-compatible executable, then compare the PDF. ### What about the wkhtmltopdf-binary gem? If the gem supplies the old executable, remove or stop using it and set exe\_path to the Marqius-compatible program you installed. ### Can I keep a table of contents? Test a document that uses your current toc options, links and page numbers. Review the complete PDF before switching. ### What if wicked\_pdf reports a bad executable path? Set exe\_path to the installed program, confirm the process can execute it, and try a small Rails view. --- Source: https://marqius.com/wkhtmltopdf/security/ Markdown: https://marqius.com/aeo/okf/products-and-guides/wkhtmltopdf-security.md SECURITY · UNTRUSTED HTML # Review your _wkhtmltopdf exposure._ The wkhtmltopdf maintainer warns against converting HTML you do not trust. Protect the converter now, then test the move to a maintained engine. [Read the project’s status](https://wkhtmltopdf.org/status) [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) [Download switching manual](https://marqius.com/download/replace-wkhtmltopdf.pdf) **HTML** untrusted input Isolation boundary **Converter** Marqius **PDF** checked output A new converter still needs isolation when it fetches URLs or receives HTML from others. ## Five safeguards to review. ### Restrict local files Allow only the files conversion needs. ### Sanitize input Clean or filter HTML from untrusted sources. ### Limit JavaScript Disable it when a document does not need it. ### Isolate network access Limit what the converter can reach. ### Plan the migration Compare real PDFs and keep a fallback. REAL-WORLD CHECK ## Check one real document. Install Marqius, render your HTML, and compare its PDF with your current tool. ``` curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash ``` **Switching manual** Examples and troubleshooting for Security and related stacks. [Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf)[14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples) [Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) PRACTICAL DETAILS ## What to check before you switch. ### What the project says The maintainer’s status page says Qt 4 is unsupported, its WebKit has not been updated since 2012, and untrusted HTML can compromise the server. Read the original advice before making a migration decision. [wkhtmltopdf project status](https://wkhtmltopdf.org/status)[Archived project repository](https://github.com/wkhtmltopdf/wkhtmltopdf) ### Five controls to review - Keep local file access off unless one folder is explicitly allowed. - Escape or sanitize values inserted into your HTML. - Disable JavaScript when the document does not need it. - Run conversion away from internal services and metadata endpoints. - Review your exit path from the archived engine. ### Where Marqius fits Marqius is maintained and does not embed the 2012 browser engine. A replacement converter still needs isolation when it fetches URLs or receives HTML from other users. Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides. QUESTIONS & ANSWERS ## Security questions ### Should I convert HTML supplied by other users without isolation? No. The wkhtmltopdf maintainer warns against untrusted HTML. Sanitize input and restrict filesystem and network access before conversion. ### Does moving to Marqius remove every conversion risk? No. Any converter that reads files or fetches URLs needs appropriate isolation and resource limits. ### What safeguards should I review first? Restrict local files, sanitize untrusted HTML, disable unnecessary JavaScript, limit outbound network access and compare real PDFs before migration. ### Where is the original project warning? The wkhtmltopdf maintainer explains the risks and recommendations on the project status page at wkhtmltopdf.org/status.