Skip to content

html2pdf v0.3.0: list markers painted #29

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tannevaled merged 1 commit into from
Oct 28, 2026
Merged

html2pdf v0.3.0: list markers painted #29

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 12 additions & 3 deletions content/writing-a-document/html-to-pdf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: "HTML to PDF"
weight: 130
---

[`go-pdfkit/html2pdf`](https://github.com/go-pdfkit/html2pdf) (v0.2.0) turns
[`go-pdfkit/html2pdf`](https://github.com/go-pdfkit/html2pdf) (v0.3.0) turns
static HTML into a **vector** PDF: go-webengine lays the page out and the
result is written through pdfkit's text, rect and stroke calls, so the text in
the PDF is real text. No headless browser is involved.
Expand All @@ -28,6 +28,15 @@ doc.Write(f)
information dictionary; an empty `Title` is taken from the document's
`<title>`.

## Lists

Since v0.3.0 (go-webengine v0.18.0) list markers are painted: `::marker`,
every `list-style-type` (disc, circle, square, decimal, the alphabetic and
roman ones, `none`), and the `start`, `reversed` and `value` attributes of
`<ol>` / `<li>`. CSS escapes in `content` strings are decoded as CSS Syntax 3
says, and CSS counters are supported. HTML that wrote its own bullets as text
to work around this should drop them: they would print twice.

## Page numbers and a table of contents

Since v0.2.0 the page's CSS can print on every page and can refer to pages.
Expand Down Expand Up @@ -58,8 +67,8 @@ The layout is run again until the numbers are stable (at most four passes).
## From the shell

```sh
go run github.com/go-pdfkit/html2pdf/cmd/html2pdf@v0.2.0 --in report.html --out report.pdf
go run github.com/go-pdfkit/html2pdf/cmd/html2pdf@v0.2.0 --url https://example.org/report --out report.pdf
go run github.com/go-pdfkit/html2pdf/cmd/html2pdf@v0.3.0 --in report.html --out report.pdf
go run github.com/go-pdfkit/html2pdf/cmd/html2pdf@v0.3.0 --url https://example.org/report --out report.pdf
```

The command is built on cobra with POSIX flags: `--in/-i`, `--url/-u`,
Expand Down
Loading