docs: Pandoc 3.13 changes for Quarto 1.12

.claude/rules/release-highlights.md

@@ -0,0 +1,14 @@
+---
+paths:
+  - "docs/prerelease/**/_highlights.qmd"
+---
+
+# Release Highlights
+
+`_highlights.qmd` is a short summary. The download page shows it above the full changelog, so details belong in the changelog. Match the length of earlier releases' highlights (compare `docs/prerelease/1.11/_highlights.qmd`).
+
+- Feature bullets: one or two sentences, linking to the docs section.
+- A dependency update (Pandoc, Typst, Deno) is one line, such as "Pandoc updated to 3.13". Its user-facing additions go in that line or as feature bullets.
+- "When upgrading" lists only changes users must act on: a render that now fails, or output that changes visibly. One sentence each, plus the fix when there is one.
+- Edge cases, niche behavior changes and per-format details stay in the quarto-cli changelog.
+- Before describing a behavior change that comes from a dependency, read the quarto-cli PR and changelog entry for it: Quarto often adjusts the result (a filter or finalizer), so the upstream release notes alone can misstate what users see.

docs/output-formats/html-basics.qmd

@@ -124,7 +124,7 @@ Using the `css` option works well for simple tweaks to document appearance. If y
 
 ## LaTeX Equations
 
-By default, LaTeX equations are rendered using [MathJax](https://www.mathjax.org/). Use the `html-math-method` option to choose another method. For example:
+By default, LaTeX equations are rendered using [MathJax](https://www.mathjax.org/). HTML documents without the Bootstrap theme (`minimal: true`, `theme: none`, or `theme: pandoc`) render them as MathML instead. Use the `html-math-method` option to choose another method. For example:
 
 ``` yaml
 format:

docs/output-formats/typst.qmd

@@ -232,6 +232,38 @@ This gets compiled to
 [This is a block with gray background and slightly rounded corners.])
 ````
 
+## Typst Labels
+
+{{< prerelease-callout 1.12 >}}
+
+The identifier of a div becomes a [Typst label](https://typst.app/docs/reference/foundations/label/) on its content, so [raw Typst](#raw-typst) code can target the div, for example with a show rule. To give the div a Typst label that differs from its identifier, or a label without an identifier, use the `typst-label` attribute:
+
+```` markdown
+```{=typst}
+#show <note-box>: set text(fill: blue)
+```
+
+::: {typst-label="note-box"}
+This text is blue.
+:::
+````
+
+A show rule applies only to content after it, so place the raw Typst block before the div.
+
+`typst-label` is for raw Typst code. To refer to a figure, table, or theorem, give it a Quarto [cross-reference](/docs/authoring/cross-references.qmd) identifier such as `#fig-plot` and use `@fig-plot`, as in other formats.
+
+## Text Language
+
+{{< prerelease-callout 1.12 >}}
+
+Set `lang` on a span or a div to write content in a language other than the document's `lang`. Typst then uses that language for the content, for example for hyphenation and smart quotes:
+
+``` markdown
+The German greeting [Guten Tag]{lang="de"} means "good day".
+```
+
+The span renders as `#text(lang: "de")[Guten Tag]`.
+
 ## Theorems
 
 {{< prerelease-callout 1.9 >}}

docs/prerelease/1.12/_highlights.qmd

@@ -1 +1,11 @@
-Quarto v1.12 was just released, nothing to see here -- yet!
+Quarto 1.12 includes the following new features:
+
+- Pandoc updated to 3.13, which adds [Typst labels](/docs/output-formats/typst.qmd#typst-labels) with the `typst-label` attribute and [`lang` on spans](/docs/output-formats/typst.qmd#text-language) in `typst` output.
+- `quarto render` supports Pandoc's `--math-method` option. The `--katex`, `--mathjax`, `--mathml`, and `--webtex` options are deprecated.
+
+When upgrading:
+
+- A duplicated key in a YAML [bibliography file](/docs/authoring/citations.qmd#bibliography-files) now stops the render with an error.
+- In `docx` output, cross-reference targets are bookmarks with generated names, so a link from outside the document such as `report.docx#fig-plot` no longer finds its target.
+- HTML documents without the Bootstrap theme (`minimal: true`, `theme: none`, or `theme: pandoc`) now render [math](/docs/output-formats/html-basics.qmd#latex-equations) as MathML. Set `html-math-method: plain` for the previous output.
+- A Typst binary set through the `QUARTO_TYPST` environment variable must be version 0.15 or later.

docs/presentations/powerpoint.qmd

@@ -78,7 +78,7 @@ When creating slides, the pptx writer chooses from a number of pre-defined layou
 
 **Content with Caption**
 
-:   This layout is used for any non-two-column slides which contain text followed by non-text (e.g. an image or a table).
+:   This layout is used for any non-two-column slides which contain text followed by an image, unless the slide also contains a table.
 
 **Blank**