Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Typst: image size in px is not converted when the image has fig-alt

Abierto Apto para principiantes
#14,947 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
75/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
lua

Línea de trabajo

El error está en src/resources/filters/quarto-post/typst.lua, líneas 218-225 y 262-273. Comience leyendo el código del filtro para ver cómo maneja las imágenes con fig-alt. La solución probablemente implica convertir las unidades px a pulgadas usando PANDOC_WRITER_OPTIONS.dpi, de manera similar a cómo se manejan los números simples. Pruebe creando un archivo .qmd mínimo con una imagen que tenga fig-alt y un tamaño en px, luego ejecute quarto render para verificar que el archivo .typ generado ya no contenga 'px'.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

accessibility bug typst
Bug description

When I render to Typst, an image with fig-alt keeps its size in px. Typst has no px unit, so compiling the document fails with invalid number suffix: px. The same image without fig-alt renders fine, because Quarto converts its size to inches.

The cause is in the Typst filter, quarto-post/typst.lua. When an image has alt text, the filter doesn't pass it on to Pandoc. It writes the Typst image() call itself as a RawInline and copies the height and width values across unchanged. The filter does convert sizes before that, but only when they're plain numbers. tonumber("200px") returns nil, so 200px ends up in the Typst code as it is.

This is where the filter builds the image() call for an image with alt text:

An image without alt text goes through Pandoc's Typst writer instead, and that writer turns pixel sizes into inches:

Sizes in % still work with fig-alt, because Typst understands %.

Checked against Pandoc

I also ran the same image through Pandoc on its own, and Pandoc isn't the cause. The Pandoc 3.10 bundled with Quarto converts the size and writes the alt text correctly:

printf 'A ![](https://quarto.org/quarto.png){height="200px" alt="Quarto logo."} b\n' | quarto pandoc -f markdown -t typst
# #box(image("https://quarto.org/quarto.png", height: 2.08333in, alt: "Quarto logo."))

A comment in the filter says the raw image() call is a workaround, because Pandoc used to leave alt text out of Typst output (jgm/pandoc#11394). Pandoc 3.10 writes alt: itself now, so the workaround might not be needed any more. For the moment, it's the code path that causes this bug.

Steps to reproduce
---
format: typst
keep-typ: true
---

![](https://quarto.org/quarto.png){height="200px"}

![](https://quarto.org/quarto.png){height="200px" fig-alt="Quarto logo."}
Actual behavior

The generated .typ file has these two lines:

#box(image("t3_files/mediabag/quarto.png", height: 2.08333in))
#box(image("t3_files/mediabag/quarto.png", alt: "Quarto logo.", height: 200px))

Typst then stops with this error:

error: invalid number suffix: `px`
Expected behavior

I'd expect the image with fig-alt to have its size converted just like the one without it:

#box(image("t3_files/mediabag/quarto.png", alt: "Quarto logo.", height: 2.08333in))

I can see two ways to fix it. The filter could convert px values to inches with PANDOC_WRITER_OPTIONS.dpi, as it already does for plain numbers. Or, now that Pandoc 3.10 writes the alt text itself, the filter could let Pandoc handle these images as well.

Your environment

I'm on macOS. The bug happens with Quarto 1.10.18 and with the current main branch at commit 03f0fdf586b066ffa81ebefa55e5dad21e08bec0.

Quarto check output

This output comes from the development build I used to confirm the bug on main.

[✓] Checking environment information...
      Quarto cache location: /Users/mcanouil/Library/Caches/quarto
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.10.0: OK
      Dart Sass version 1.101.0: OK
      Deno version 2.7.14: OK
      Typst version 0.15.1: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 99.9.9
      commit: 03f0fdf586b066ffa81ebefa55e5dad21e08bec0
      Path: /Users/mcanouil/Projects/quarto-dev/quarto-cli/package/dist/bin

[✓] Checking tools....................OK
      TinyTeX: v2026.07
      Chrome Headless Shell: (not installed)
      VeraPDF: (not installed)

[✓] Checking LaTeX....................OK
      Using: TinyTex
      Path: /Users/mcanouil/Library/TinyTeX/bin/universal-darwin
      Version: 2026

[✓] Checking Chrome Headless....................OK
      Using: Chrome from QUARTO_CHROMIUM
      Path: /Applications/Brave Browser.app/Contents/MacOS/Brave Browser

[✓] Checking basic markdown render....OK

ℹ R version 4.6.1 (2026-06-24)
! Config '~/.Rprofile' was loaded!
[✓] Checking R installation...........OK
      Version: 4.6.1
      Path: /Library/Frameworks/R.framework/Versions/4.6/Resources
      LibPaths:
        - /Users/mcanouil/Projects/quarto-dev/quarto-playground/renv/library/macos/R-4.6/aarch64-apple-darwin23
        - /Users/mcanouil/Library/Caches/org.R-project.R/R/renv/sandbox/macos/R-4.6/aarch64-apple-darwin23/46003b10
      knitr: 1.51
      rmarkdown: 2.31

[✓] Checking Knitr engine render......OK

[✓] Checking Python 3 installation....OK
      Version: 3.9.6
      Path: /Library/Developer/CommandLineTools/usr/bin/python3
      Jupyter: (None)

      Jupyter is not available in this Python installation.
      Install with python3 -m pip install jupyter

      There is an unactivated Python environment in .venv. Did you forget to activate it?

[✓] Checking Julia installation...
Lenguaje dominante
JavaScript
Estrellas
6k
Forks
458
Merge medio
1 d 3 h
PR fusionados (30 d)
54

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de quarto-dev/quarto-cli

Todos los issues de quarto-dev/quarto-cli

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.