I'm pleased to announce the release of pandoc 3.11,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.11
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.11
Some changes of note:
- A new `--math-method` option, which replaces the (now deprecated but
still functional) options `--mathml`, `--mathjax`, `--gladtex`,
`--katex`, `--webtex`. The `plain` style can now be specified
explicitly. In defaults files, `html-math-method` is now
`math-method` (though `html-math-method` will still work).
- `mathml` is now the default math-method.
- A new option `--completion={bash,zsh,fish}` generates completion
scripts for all three shells (see the manual for instructions on
how to use them). `--bash-completion` continues ot work, an alias of
`--completion=bash`.
- It is now possible to reset a Markdown example list counter (e.g.,
at the beginning of a chapter), using the syntax `(1@)` or
`(1@label)`.
- Enhanced support for RTL languages: RTL text direction now
works in ODT. In addition, setting `lang` at the document level
is now sufficient in Docx to make documents RTL.
- Fixed pandoc 3.8 regressions in syntax highlighting.
- Fixed a security-related bug in template fetching which
could result in a local file being fetched instead of a
remote one.
API changes:
- Text.Pandoc.Options: Rename HTMLMathMethod type to MathMethod.
Rename `writerHTMLMathMethod` field of WriterOptions to
`writerMathMethod`.
- Text.Pandoc.App: the `optHTMLMathMethod` constructor for OPt
is renamed to optMathMethod.
Thanks to all who contributed, especially new contributors Wrong-Code
and wzy.
Click to expand changelog
-
Add
--math-methodoption. This replaces (now deprecated but still functional) options--mathml,--mathjax,--gladtex,--katex,--webtex. Theplainstyle can now be specified explicitly. In defaults files,html-math-methodis nowmath-method(thoughhtml-math-methodwill still work). -
Make
mathmlthe default math-method (#11751). -
Add
--completion={bash,zsh,fish}(#8542, wzy). Make--bash-completionan alias of--completion=bash. See the manual for instructions on how to use these completions. -
Text.Pandoc.Options [API change]:
- Rename HTMLMathMethod type to MathMethod.
- Rename
writerHTMLMathMethodfield of WriterOptions towriterMathMethod.
-
Markdown reader:
- Add a syntax
(1@label)for resetting example list counter (#10940). This is needed often at the beginning of a chapter.
- Add a syntax
-
MediaWiki writer:
- Put
<nowiki>around possible URLs (#11834). Otherwise they get linkified automatically.
- Put
-
Docx reader:
-
RTF Reader:
- Add support for nested tables (#11218, Alex).
-
Typst reader:
- Remove handling of ‘block’ as an inline-level element (#11814).
-
HTML reader:
- Handle
prewithoutcode(#11810). Preserve whitespace as nonbreaking spaces.
- Handle
-
ODT/OpenDocument writers:
- Support RTL text direction (#11301). RTL is now properly handled in these cases:
dir: rtl(orltr) in document metadata; an RTLlangin metadata (e.g.he,ar), unless overridden bydir; adirattribute on a Div. Code blocks remain ltr regardless. - Use
style:language-complexrather thanfo:languagefor RTL languages (#11301). - Fix treatment of DefaultHighlighting (#11829).
- Support RTL text direction (#11301). RTL is now properly handled in these cases:
-
Docx writer:
- Initialize envLang from
langmetadata (#11301). This ensures that settinglangwill affect the whole document. Previously, settinglangtohewas not sufficient to make the document RTL.
- Initialize envLang from
-
JATS writer:
- Fix illegal use of
pelement insidep(#11809).
- Fix illegal use of
-
Ms writer:
- Fix treatment of DefaultHighlighting (#11829). (Regression from 3.8.)
-
ConTeXt writer:
- Fix bug in syntax highlighting (#11829). (Regression from 3.8.)
-
Text.Pandoc.App.Opt:
- In Opt, change
optHTMLMathMethodtooptMathMethod. [API change]
- In Opt, change
-
MSI installer: Fix upgrade detection for per-machine installations (#11827, Wrong-Code). Previously, registry records of previous versions were not being removed.
-
Text.Pandoc.Templates:
- Fix bug in
getTemplate. When callingfetchItemingetTemplate, we temporarily reset thestSourceURLin CommonState so that the template is sought locally. Previously, an exception infetchItemwould preventstSourceURLfrom being set back to its original value. This could result in a local file being fetched instead of a remote one. Note that an exception is triggered when one uses e.g.--template default.html5; in that casegetTemplatehandles the exception by looking for the file in the user data directory. This patch fixes the bug so that thestSourceURLis reset regardless of whetherfetchItemraises an exception. Thanks to Yingjie Su for identifying the problem.
- Fix bug in
-
beamer template: remove spurious extra tableofcontents (#11819).
-
Text.Pandoc.App.CommandLineOptions:
- Export OptionSpec, which can encode the type of completion needed by each option (wzy).
-
Add new unexported module Text.Pandoc.Completion (wzy).
-
Replace a use of
nubwithnubOrd. -
Use latest releases of djot, asciidoc, typst, texmath.
-
MANUAL.txt:
- Add a note that
thanksin typst doesn’t currently work (#11807). - Note that sourcepos extension works for djot too.
- Add a note that