You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Add front matter: author, description, image, image-alt, draft
- Use layout-ncol=2 instead of panel-tabset for YAML examples
- Clarify veraPDF behavior when not installed
- Reword Java install requirement
- Fix wording: "due to missing titles or missing alt text"
Copy file name to clipboardExpand all lines: docs/blog/posts/2026-02-xx-pdf-accessibility-and-standards/index.qmd
+18-9Lines changed: 18 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,12 @@
1
1
---
2
2
title: PDF Accessibility and Standards
3
+
description: |
4
+
Quarto 1.9 brings PDF accessibility and standards support, building on new tagging features in LaTeX and Typst.
5
+
author: Gordon Woodhull
6
+
date: "2026-02-xx"
7
+
image: verapdf.jpg
8
+
image-alt: "veraPDF logo"
9
+
draft: true
3
10
---
4
11
5
12
2025 was a big year for PDF accessibility. LaTeX and Typst both released support for PDF tagging and accessibility standards, just in time for new regulations in the [EU](https://en.wikipedia.org/wiki/European_Accessibility_Act) (June 2025) and [US](https://accessible.org/ada-title-ii-web-accessibility/) (April 2026).
@@ -21,39 +28,41 @@ Both standards instruct the PDF renderer to provide screen readers:
21
28
22
29
In Quarto 1.9, specify a PDF standard for your document or project with `pdf-standard`
23
30
24
-
::: panel-tabset
25
-
## PDF (LaTeX)
31
+
::::: {layout-ncol=2}
32
+
:::: {}
33
+
**PDF (LaTeX)**
26
34
27
35
```yaml
28
36
format:
29
37
pdf:
30
38
pdf-standard: ua-2
31
39
```
40
+
::::
32
41
33
-
## Typst
42
+
:::: {}
43
+
**Typst**
34
44
35
45
```yaml
36
46
format:
37
47
typst:
38
48
pdf-standard: ua-1
39
49
```
40
-
:::
50
+
::::
51
+
:::::
41
52
42
53
`pdf-standard` takes a single standard name or list of standard names. PDF version is used if provided in the list, but otherwise inferred from the standard.
43
54
44
-
If you specify a PDF standard, Quarto first instructs LaTeX or Typst to use the standard when producing the PDF, and then validates the output PDF against the standard using veraPDF, an open-source PDF validation tool.
55
+
If you specify a PDF standard, Quarto first instructs LaTeX or Typst to use the standard when producing the PDF, and then validates the output PDF against the standard using veraPDF, an open-source PDF validation tool. If veraPDF is not installed, you'll get a warning but still receive a PDF -- it just won't be validated.
45
56
46
57
::: {.callout-note}
47
58
## Installing veraPDF
48
59
49
-
veraPDF requires a separate install:
60
+
To install veraPDF, you'll first need Java, then run:
50
61
51
62
```{.bash filename="Terminal"}
52
63
quarto install verapdf
53
64
```
54
65
55
-
veraPDF requires Java.
56
-
57
66
:::
58
67
59
68
When a document passes validation, you'll see output like:
@@ -93,7 +102,7 @@ There are smaller upstream issues in Pandoc, LaTeX, and LaTeX packages, [documen
93
102
94
103
In our tests, Typst catches every UA-1 violation, and fails to generate the PDF. veraPDF did not detect any violation that Typst did not.
95
104
96
-
Typst also seems to do a very good job of generating UA-1 compliant output by default -- almost all errors were titles and alt text.
105
+
Typst also seems to do a very good job of generating UA-1 compliant output by default -- almost all errors were due to missing titles or missing alt text.
97
106
98
107
However, we did discover that [Typst Books](/docs/books/book-output.qmd#typst-output) are not yet compliant. There is a [structural problem with the Typst orange-book package](https://github.com/flavio20002/typst-orange-template/issues/38) and we'll work with the maintainers to correct it.
0 commit comments