WEASYPRINT(1)

📦
version 69.0 · 6 versions
, in ubuntu stonking

💖 WEASYPRINT 💖

okay bestie, sit down, hydrate, because today we're talking about WeasyPrint — aka The Awesome Document Factory, and yes that is its literal official subtitle, the manpage is not being cute, it just IS that iconic. 🌸

We're living in the WEASYPRINT(1) manual page, general commands, and I'm about to walk you through every single flag like we're ranking them on a tier list. No skipping. We do not skip. Not on my watch. 💅

✨ NAME ✨

weasyprint — The Awesome Document Factory 🏭✨

weasyprint.__main__.main(argv=sys.argv)

okay so the weasyprint program is lowkey demanding, it needs at least two arguments fr fr:

weasyprint [options] <input> <output>
  • input — the URL or filename of your HTML input. and yes, you can just hit it with - and feed it stdin like a little legend. 💫
  • output — the filename where the output gets written. or - for stdout, because sometimes you just want it in your face immediately. 🫶

🎀 the lil "just give me info" flags

  • -i, --info — prints system information and then dips. exit stage left. 👋
  • --version — prints WeasyPrint's version number and peaces out. the classic "who even am I" move. 🌈

🎨 RENDERING OPTIONS 🎨

this is the main character section, ngl. this is where the magic happens. 🔥

  • -s <stylesheet>, --stylesheet <stylesheet> — URL or filename for a user CSS stylesheet. and bestie, you can pass this option multiple times — stack them like bracelets. 🎀
  • -a <attachment>, --attachment <attachment> — URL or filename of a file to attach to the PDF document. also passable multiple times, collect them all. 🧚
  • --attachment-relationship <attachment-relationship> — the relationship of the attachment file to attach to the PDF. yep, also multiple times. the attachment lore runs deep.
  • --pdf-identifier <pdf-identifier> — the PDF file identifier. it's giving "everyone needs a little ID". 🪪
  • --pdf-variant <pdf-variant> — which PDF variant to generate. the possible choices are a whole buffet:
    • pdf/a-1b, pdf/a-2b, pdf/a-3b, pdf/a-2u, pdf/a-3u, pdf/a-4u, pdf/a-1a, pdf/a-2a, pdf/a-3a, pdf/a-4e, pdf/a-4f, pdf/ua-1, pdf/ua-2, pdf/x-1a, pdf/x-3, pdf/x-4, pdf/x-5g, debug
    • that's a LOT of choices and honestly? slay for having options.
  • --pdf-version <pdf-version> — the PDF version number. just a number, no drama.
  • --pdf-forms — includes PDF forms. forms!! interactive!! ✨
  • --pdf-tags — tags the PDF for accessibility. accessibility is not a vibe, it's a standard, and we love it here. 👑
  • --uncompressed-pdf — do not compress the PDF content. it says "mainly for debugging purpose" so like, it's for the detective work, not for shipping. 🔍
  • --xmp-metadata <xmp-metadata> — URL or filename of a file to include into the XMP metadata. and yeah, multiple times is allowed. the metadata stacking goes crazy.
  • --custom-metadata — includes custom HTML meta tags in the PDF metadata. your meta, your rules. 🦋
  • --output-intent <output-intent> — Srgb, device-cmyk, or a CSS identifier of the output intent color space. pick your color destiny. 🌈
  • -p, --presentational-hints — follow HTML presentational hints. the old-school hints get to speak too. 🗣️
  • --optimize-images — optimizes the size of embedded images with no quality loss. free glow-up, zero cost. ate. 💅
  • -j <jpeg-quality>, --jpeg-quality <jpeg-quality> — JPEG quality between 0 (worst) to 95 (best). note that it tops out at 95, not 100, that's just the deal, don't argue with the numbers. 😭
  • -D <dpi>, --dpi <dpi> — sets the maximum resolution of images embedded in the PDF. crisp or crunchy, your call. 🍓
  • --full-fonts — embeds unmodified font files when possible. the whole font. unbothered. unedited. un-chopped. 👑
  • --hinting — keeps the hinting information in embedded fonts. the little hints stay ✨
  • -c <cache-folder>, --cache-folder <cache-folder> — stores the cache on disk instead of memory. the folder is created if needed and cleaned after the PDF is generated. it literally cleans up after itself, main character behavior. 🧹

🌐 HTML OPTIONS 🌐

  • -e <encoding>, --encoding <encoding> — force the input character encoding. no guessing games. 🔒
  • -m <media-type>, --media-type <media-type> — the media type to use for @media. it defaults to print. as it should. 🖨️
  • -u <base-url>, --base-url <base-url> — the base for relative URLs in the HTML input. it defaults to the input's own filename or URL, or the current directory for stdin. so it figures it out for you, but you can also just tell it. 🫶

📡 URL FETCHER OPTIONS 📡

  • -t <timeout>, --timeout <timeout> — set the timeout in seconds for HTTP requests. don't let the network hold you hostage. ⏰
  • --allowed-protocols <allowed-protocols> — only authorizes a comma-separated list of protocols for fetching URLs. allowlist energy. 🛂
  • --no-http-redirects — do not follow HTTP redirects. we stay. we do not chase. 💀
  • --fail-on-http-errors — abort document rendering on any HTTP error. ruthless. honestly? respect.

💫 The Awesome Document Factory 💫

WeasyPrint is a smart solution helping web developers to create PDF documents. It turns simple HTML pages into gorgeous statistical reports, invoices, tickets… and like, that's genuinely the plot. simple in, gorgeous out. 🎀

From a technical point of view, WeasyPrint is a visual rendering engine for HTML and CSS that can export to PDF. It aims to support web standards for printing. WeasyPrint is free software made available under a BSD license. 🌸

It is based on various libraries but not on a full rendering engine like WebKit or Gecko. The CSS layout engine is written in Python, designed for pagination, and meant to be easy to hack on. so yes bestie, you can hack on it, go forth. 🔥

WeasyPrint has been created and developed by Kozea (<https://kozea.fr/>). Professional support, maintenance and community management is provided by CourtBouillon (<https://www.courtbouillon.org/>). 👑

Copyrights are retained by their contributors, and no copyright assignment is required to contribute to WeasyPrint. Unless explicitly stated otherwise, any contribution intentionally submitted for inclusion is licensed under the BSD 3-clause license, without any additional terms or conditions. For full authorship information, see the version control history. 🕰️

🌟 Author 🌟

Simon Sapin and contributors 💜

Simon Sapin and contributors 💜

okay and finally, the lil sign-off, the credits roll: this is WeasyPrint version 69.0, dated Jun 22, 2026, and it lives in the WEASYPRINT(1) manual section. that's the whole page, bestie. go make some gorgeous PDFs. periodt. 💅✨🦋

📦 where this page comes from