Install¶
v=$(curl -fsSL https://kolinsky.spenhouet.com/releases/latest.json | sed -n 's/.*"version": "\([^"]*\)".*/\1/p') && curl -fsSL "https://kolinsky.spenhouet.com/releases/v$v/kolinsky-$v-x86_64-unknown-linux-gnu.tar.gz" | tar xz && sudo mv "kolinsky-$v-x86_64-unknown-linux-gnu/kolinsky" /usr/local/bin/
v=$(curl -fsSL https://kolinsky.spenhouet.com/releases/latest.json | sed -n 's/.*"version": "\([^"]*\)".*/\1/p') && curl -fsSL "https://kolinsky.spenhouet.com/releases/v$v/kolinsky-$v-aarch64-unknown-linux-gnu.tar.gz" | tar xz && sudo mv "kolinsky-$v-aarch64-unknown-linux-gnu/kolinsky" /usr/local/bin/
From HTML to PDF¶
use kolinsky::{Engine, Input, PdfOptions, RenderOptions};
fn main() -> Result<(), Box<dyn std::error::Error>> {
let engine = Engine::new();
let input = Input::Path("hello.html".into());
let rendered = engine.render(input, &RenderOptions::default(), &PdfOptions::default())?;
for d in &rendered.diagnostics {
eprintln!("{}: {}", d.code, d.message);
}
std::fs::write("hello.pdf", rendered.output)?;
Ok(())
}
hello.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Invoice 2026-042</title>
<style>
@page {
size: A6 landscape;
margin: 12mm 12mm 14mm;
@bottom-right { content: "Page " counter(page) " of " counter(pages); font: 7pt sans-serif; color: #777 }
}
body { font: 9pt/1.4 sans-serif; color: #222 }
header { display: flex; justify-content: space-between; align-items: baseline;
border-bottom: 2px solid #c25129; margin-bottom: 4mm }
h1 { font-size: 16pt; margin: 0; color: #c25129 }
table { width: 100%; border-collapse: collapse }
th, td { padding: 1.2mm 2mm; border-bottom: 0.5pt solid #ddd; text-align: left }
td:last-child, th:last-child { text-align: right }
tfoot td { font-weight: bold; border-bottom: none }
</style>
</head>
<body>
<header><h1>Invoice</h1><span>No. 2026-042</span></header>
<table>
<thead><tr><th>Item</th><th>Hours</th><th>Amount</th></tr></thead>
<tbody>
<tr><td>Layout review</td><td>4</td><td>€ 480.00</td></tr>
<tr><td>Print stylesheet</td><td>6</td><td>€ 720.00</td></tr>
<tr><td>PDF/UA check</td><td>2</td><td>€ 240.00</td></tr>
</tbody>
<tfoot><tr><td>Total</td><td></td><td>€ 1,440.00</td></tr></tfoot>
</table>
</body>
</html>

The image is the PDF that these lines write, rasterized; the docs build renders it with kolinsky every time.
Speed¶
Wall time per document, from process start to the PDF written, on a log scale. Shorter is faster.
Measured on 2026-11-12 on one machine (x86_64 12 CPUs), all engines with the same fonts.
Conformance¶
The share of tests passed: overall, in the web area (CSS and SVG reftests of the web-platform-tests) and in the PDF area (PDF feature and paged-media checks).
Results of 2026-11-14, web-platform-tests commit 4c84956f8341.
Every engine, method and the scores per group
Features¶
- Paged media:
@pagesizes and margins, the 16 margin boxes, page counters, named pages, running headers - Flexbox and grid: flex containers and CSS grid, also split across pages
- Multi-column: columns with balancing, spanners and column rules
- Floats and positioning: floats, absolute, fixed and relative positioning
- Tables: fixed and automatic layout, collapsed borders, headers and footers repeated on every page
- Fonts and complex scripts:
@font-facewith WOFF, OpenType features, Arabic, Indic, Thai and CJK shaping, bidirectional text, hyphenation - SVG and images: inline and external SVG, PNG, JPEG, GIF and WebP
- Links and outline: internal and external links, PDF bookmarks from headings
- PDF/A, PDF/UA and tagged PDF: PDF/A-2b, A-3u and A-4, PDF/UA-1 and UA-2, structure tags
- Forms and attachments: HTML form controls drawn on the page, files embedded with
--attachor by the document - Network off by default: documents load only local files unless you allow URLs
- No system dependencies: one binary or wheel on Linux, macOS and Windows; fonts come from the system or your own folders