Skip to content

docs: Pandoc 3.13 changes for Quarto 1.12 - #2355

Open
cderv wants to merge 5 commits into
prereleasefrom
docs/pandoc-3.13
Open

cderv wants to merge 5 commits into
prereleasefrom
docs/pandoc-3.13

Conversation

@cderv

@cderv cderv commented Nov 12, 2026 •

Copy link
Copy Markdown
Member

Quarto 1.12 updates Pandoc from 3.10 to 3.13. Some of its changes alter existing documents, and its Typst writer reads two new attributes, so the docs need to follow.

  • The 1.12 pre-release highlights mention the Pandoc update in one line, like earlier releases, and list under "When upgrading" only the changes users must act on: duplicate bibliography keys, Word bookmark names, MathML in HTML without Bootstrap, and the Typst 0.15 requirement for QUARTO_TYPST. Other changes stay in the changelog (Reorganize Pandoc 3.13 changelog entries quarto-cli#15351).
  • The HTML page now says that math renders as MathML in HTML without the Bootstrap theme (minimal: true, theme: none, theme: pandoc). It was plain text with Pandoc 3.10.
  • The Typst page documents typst-label on divs and lang on spans. typst-label is shown as a way to target a div from raw Typst, for example with a show rule. Cross-references keep using Quarto identifiers, as Quarto's crossref labels don't use it.
  • The PowerPoint page no longer lists tables for the Content with Caption layout, as a slide with text followed by a table now uses Title and Content. Two-column slides with a table still use Comparison.
  • A new .claude/rules/release-highlights.md rule keeps highlights short and asks to check the quarto-cli PR before describing a dependency's behavior change. It is also proposed directly on main.

Targets prerelease because these changes ship in 1.12, and should merge after quarto-dev/quarto-cli#15320.

Test Plan

  • Each new example rendered with a Quarto dev build using Pandoc 3.13 and with Quarto 1.11.9 (Pandoc 3.10): the Typst label and #text(lang:) appear only with 3.13, the three non-Bootstrap HTML setups get MathML only with 3.13, text followed by a table gets Title and Content only with 3.13, and a two-column slide with a table gets Comparison with both
  • The edited pages and the pages that include the 1.12 highlights render with --profile prerelease-docs, and the new links resolve to existing anchors

Companion to quarto-dev/quarto-cli#15320

Pandoc 3.13, bundled with Quarto 1.12, puts a non-two-column slide that
contains a table on the Title and Content layout, so text followed by a
table no longer selects Content with Caption as it did with Pandoc 3.10.
Text followed by an image still does. Two-column slides are unchanged:
a column with text followed by a table still selects Comparison.
Quarto 1.12 bundles Pandoc 3.13, which reads two attributes in Typst
output that Pandoc 3.10, bundled with Quarto 1.11, ignored. A div with a
typst-label attribute gets that Typst label, replacing the label Pandoc
already derived from the div's identifier; the attribute was added in
Pandoc 3.10.2. A span with lang now renders as #text(lang: ...)[...],
where Pandoc 3.10 dropped the attribute; lang on a div already worked.

The labels section says that typst-label is for raw Typst code, and that
cross-references keep using Quarto identifiers: Quarto's crossref filters
write their own labels, and typst-label has no consistent effect on them
(no label on a figure, an extra label on a theorem).
Quarto 1.12 bundles Pandoc 3.13. The highlights list the changes that
can break an existing document under "When upgrading", following the
1.11 page: bibliography files with duplicate keys, particle sorting,
Word bookmark names and percent image widths, MathML in HTML without
Bootstrap, divs that wrap a heading, and Typst horizontal rules with the
Typst 0.15 requirement for QUARTO_TYPST. Smaller changes stay in the
changelog.

The LaTeX Equations section of the HTML page said MathJax is the
default. That is true for Bootstrap HTML only; minimal: true, theme: none
and theme: pandoc now render math as MathML, where Pandoc 3.10 left it
as plain text.
@github-actions

Copy link
Copy Markdown
Contributor

@cderv
cderv marked this pull request as ready for review November 12, 2026 17:23
Earlier highlights mention a Pandoc update in one line and keep the
"When upgrading" list to changes users must act on. The list now keeps
the changes that stop a render or visibly change output: duplicate
bibliography keys, Word bookmark names, MathML in HTML without Bootstrap
and the Typst 0.15 requirement for QUARTO_TYPST. Particle sorting, Word
percent widths, Typst horizontal rules and divs wrapping a heading stay
in the changelog, which the download page shows in full.
The 1.12 draft listed every Pandoc 3.13 change and described the
div-around-heading change from the Pandoc release notes, missing the
finalizer quarto-cli added for it. Earlier releases keep highlights
short and leave details to the changelog shown on the download page.
@github-actions

Copy link
Copy Markdown
Contributor

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant