pandoc 3.6.4 #10694

jgm · 2025-03-16T19:05:43Z

jgm
Mar 16, 2025
Maintainer

I'm pleased to announce the release of pandoc 3.6.4,
available in the usual places:

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.6.4

Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.6.4

This is mostly a bug fix release.  It incorporates new
versions of the typst and texmath libraries, which should result
in more accurate parsing and rendering. Changes of special note:

- We have made a small change in how pandoc parses list items,
  which makes it closer to commonmark and avoids some bad
  outcomes.  But if you're using HTML comments to comment out
  list items, this may result in an unwanted behavior change.
  Please see the changelog for details.
- The citations extension is now automatically disabled in the
  output format if --citeproc is used, to ensure that the generated
  citations will be used instead of native citation codes.
- The warning for unspecified title in HTML output is now
  an info-level message; use --verbose if you want to see it.

Thanks to all who contributed, especially new contributors
Olivier Dossmann, Tiago-Manzato, etclub, and josch.

Click to expand changelog

Disable citations extension in writers if --citeproc is used (Make it easier to use typst output with --citeproc #10662). Otherwise we get undesirable results, as the format’s native citation mechanism is used instead of (or in addition to) the citeproc-generated citations.
Markdown reader:
- Allow line break between URL and title of link (markdown to HTML: URL links with optional title on next line are broken #10621).
- Give better position information when YAML metadata parsing fails with a YAML exception (Misleading "YAML parse exception" #10231).
- Fixed escapedChar' parser ([Markdown -> HTML] Escaped newlines insert the backslash into rendered document #10672). It should not accept escaped newlines.
- Remove some misguided list fanciness (Fenced code block as a list item #9865, Definition lists: HTML comment edge case #7778, cf. Markdown reader: handle inline code more eagerly within lists. #5628). Previously we tried to handle things like commented out list items:
```
- one

- three
```
  and also things like:
```
- one `and
- two` and
```
  But the code we added to handle these cases caused problems with other, more straightforward things, like:
```
- one
- ```
  code
  ```
  - three
```
So we are rolling back all the fanciness, so that the markdown parser now behaves more like the commonmark parser, in which indicators of block-level structure always take priority over indicators of inline structure.
HTML reader:
- Skip MathJaX-introduced cruft (Can't convert HTML MathJax to markdown #10673).
- Ignore style tags in the body (Do not treat <style> elements in <body> as a newline #10643).
LaTeX reader:
- Better handle comments/whitespace in option lists and includes (Latex linebreak within includegraphics doesn't (always) work #10659).
- Support \newline, \linebreak.
Docx reader/writer:
- Revert commit adding row heads (cbe67b9) (docx table with w:firstColumn unmerges cells #10627). Word sets w:firstColumn="1" by default for tables. You have to find the Table Design tab and explicitly uncheck “First Column” to make this go away. In most cases, I don’t think writers intend to designate the first column as a row head, so this commit is going to produce unexpected results. In addition, because of the table normalization done by pandoc-type’s tableWith, any table containing a colspanned cell in the left-hand column will get broken if the first column is designated a row head. For these reasons it seems best to revert this change, which was made in response to DOCX reader to support row head #9495.
LaTeX writer and template:
- Remove selnolig-langs (Regression for LuaLaTeX: ligatures not suppressed anymore #9863). We now specify the language as a global option again, so we no longer need to specify it when invoking selnolig.
- Use babel options shorthands=off (Babel's shorthand option makes some characters to be skipped #6817).
- Use * for multirow width when no colwidth specified (Multirow column takes all the width in a table without setting colwidth #10685). Otherwise the multirow will be excessively wide.
- Protect \phantomsection (Latex: allow phantomsection in captions #10688, etclub).
Markdown writer:
- Omit extra space after bullets (Remove spaces after list marker #7172). Those who want the old behavior can obtain it by using -t markdown+four_space_rule.
- Treat Emph [Emph ils]] as ils (Alternate nested emphasis and strong emphasis delimiters in Markdown writer #10642). Otherwise we get **content** which means strong emphasis.
EPUB writer:
- Use a nonbreaking space after section number in nav.xhtml. This seems to be required for iOS books app to display the space.
Typst writer:
- Better heuristics for escaping potential list markers (inhibit enumerated lists for typst #10650).
- Ensure that citation-style works as well as csl (Different behaviour for csl & citation-style metadata field in typst export #10661).
Powerpoint writer:
- Avoid extra blank lines before author when there is no subtitle (The author-line in Powerpoint files is prepended by two newlines #10619).
JATS template:
- Fix typo in author prefix in article.jats_publishing template (Update article.jats_publishing #10622, Tiago-Manzato).
Text.Pandoc.Parsing:
- Smart quote parsing: ignore curly quotes (Latex writer: ?‘ produces ?' rather than ?` #10610). Previously we tried to match curly quotes as well as straight quotes, producing Quoted inlines. But it seems better just to assume that those who use curly quotes want them passed through verbatim. This also fixes an (unintended) bug whereby curly single left quotes would sometimes be changed to single right quotes.
Text.Pandoc.Shared:
- makeSections: put some attributes on section element only. Certain role and epub:type attributes should only be on the section (and indeed, many roles give a validation error if left on the heading element).
Text.Pandoc.Logging:
- Change NoTitleElement from WARNING to INFO (Promote "nonempty <title> element" message from WARNING to INFO #10671). Users commonly complain about the warning when producing HTML documents without an explicit title. It seems that an info message is more appropriate, since pandoc’s default here (using the input’s base name) ensures compliance with the standard and many users are happy with that default. Those who want to make sure the message is seen can use --verbose.
Beamer template: only emit \date if set (data/templates/default.beamer: only emit \date if set #10687, josch).
Fix invalid OOXML in definition_list.docx test (Possibly invalid test: definition-list.docx #10394).
MANUAL.txt:
- Correct typo: ‘date’ for doubled ‘title’ (MANUAL: correct missing 'date' as possible block entry in metadata #10654, Olivier Dossmann).
- Add note about template variable for typst.
- Change maxwidth default in MANUAL.txt (Wrong maxwidth default (HTML output) in Manual #10683).
- Improve EPUB metadata documentation.
- In Security section, alert readers to a threat relating to iframe in HTML, and add LaTeX, Typst to the list of formats that have an include (SSRF When Generating PDFs from User-Controlled HTML #10682).
doc/lua-filters.md: Add missing html_math_method ‘katex’ (R. N. West).
Use texmath 0.12.9.
Use typst 0.7. Fixes an issue with package loading, a regression in pandoc 3.6.3.

This discussion was created from the release pandoc 3.6.4.

benz0li · 2025-03-17T05:32:59Z

benz0li
Mar 17, 2025
Sponsor

Unofficial Linux/RISC-V 64-bit (linux/riscv64) release assets are available at https://gitlab.b-data.ch/jgm/pandoc/-/releases/3.6.4.

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

pandoc 3.6.4 #10694

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Uh oh!

pandoc 3.6.4 #10694

Uh oh!

Uh oh!

jgm Mar 16, 2025 Maintainer

Replies: 1 comment

Uh oh!

benz0li Mar 17, 2025 Sponsor

jgm
Mar 16, 2025
Maintainer

benz0li
Mar 17, 2025
Sponsor