Pandoc: baixar versions anteriors

I'm pleased to announce the release of pandoc 3.13, available in the usual places.

Behavior changes:
- Locations of errors in default files are now reported.
- YAML is now parsed with the yamlet library, which implements YAML 1.2. As a result, we'll get better error messages, and:
- yes, no, on, off, y and n are strings, not booleans.
- Duplicate keys in a mapping are an error. They were a warning.
- .5, .inf and .nan are numbers.
The most likely way this change will bite you is if you use no in a boolean field. This will be interpreted as a nonempty value, which will be treated as truthy in a template.

API changes:
- Text.Pandoc.Sharde: export plainToPara and paraToPlain.
- Text.Pandoc.Writers.Shared: export new functions wrapColumns and rendereWithTemplate.
- Text.Pandoc.Translations: readTranslations now takes the path of the file as argument.

Thanks to all who contributed, especially new contributors Andrzej Rybczak, Patrick Creighton, Wleeaf, and enieuwy.

- Report the location of errors in defaults files (#8759, Andrzej Rybczak). An invalid value in a defaults file gave an error at the start of the file, with no indication of the field. The error now names the option and points at its value.
- Use yamlet for YAML parsing. Pandoc parsed YAML with the yaml package, which depends on the C library libyaml. It now uses yamlet, a pure Haskell YAML 1.2 parser. Values still go through the existing aeson instances. Note these behavior changes:
- yes, no, on, off, y and n are strings, not booleans, as in YAML 1.2.
- YAML errors now show the file, the line and the column, with the offending line. In metadata blocks the line is the line in the document.
- Duplicate keys in a mapping are an error. They were a warning.
- .5, .inf and .nan are numbers.
- Docx reader:
- Read w:fldSimple fields (#11944, Aslak Hellesøy).
- Keep grid columns that have no width (#11989, Patrick Creighton). w:w is optional on w:gridCol, but elemToTblGrid skipped the grid columns that had none. The table then had fewer columns than its rows had cells, and the extra cells were dropped. Every grid column is now kept. If any of them has no (readable) width, all columns get the default width.
- Fix namespaces in notes and comments (#11991, Patrick Creighton). The contents of footnotes, endnotes and comments were read with the namespace prefixes declared in word/document.xml rather than in their own parts.
- Records the indentation of each list level and track the open list levels; an unnumbered paragraph whose left indentation matches the text indentation of an open level is treated as a continuation of that level’s current item, rather than as a block quote (cf. #9197).
- Recover from fields with a missing instruction (#11943, enieuwy). This fixes a bug that could lead to content being omitted.
- Fix regression (from 3.11) in parsing column widths (#11969). The regression caused only the first column to get assigned its alignment; every other column received default alignment. In addition, in 3.11 alignment was taken from the header row if present; this changed behavior from earlier versions, which took it from the first body row. We revert to the earlier behavior, using the header row only if there are no body rows. It’s common for the header to have different alignment than the rest.
- Keep tracked paragraph marks inside notes (#11971, Aslak Hellesøy).
- RST reader:
- Allow inline markup and bare links after :, /, ', ", < (Wleeaf). Fixes a regression since 3.2.1; these characters could no longer precede an inline markup start-string or a bare URI or email address, although the reStructuredText spec allows them. Also implement the rule that a start-character between an opening character and its closing counterpart, as in (*) or "*", does not trigger inline markup.
- RTF reader:
- Fix tokenization bug (#11981). We were consuming certain symbols after \uNNNN during tokenization. This led to an extra character being consumed as the “fallback,” so letters went m

I'm pleased to announce the release of pandoc 3.12.1,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.12.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.12.1
Notable changes:
- New input and output format: fodt (a flattened representation
of an ODT in a single XML file).
- With --citeproc, we no longer extract particles from given and family
names in structured CSL JSON or CSL YAML references. Thus, for
example, family: de Gaulle should not create a non-dropping
particle "de"; "de Gaulle" should be considered the integral
family name. This is a behavior change that could affect some
bibliography processing.
- Fixed a regression in keyword resolution with --syntax-definition.
- Fixed a serious regression in escaping of data URIs (#11942), which
broke --embed-resources.
- Fixed reveal.js version to align with plugin changes from 3.12.
- Fixed a Markdown reader regression that led to "alerts" not working
properly.
- Fixed a regression in rendering of abstracts in ODT.
- Big performance improvements for XML-based writers and the org,
man, Textile, MediaWiki, and docx readers.
API changes:
- Add readFODT to Text.Pandoc.Readers.ODT.
- Add writeFODT to Text.Pandoc.Writers.ODT.
Thanks to all who contributed, especially new contributors
Aslak Hellesøy, Erik Demaine, Raffaele Mancuso, Kyohei Takahashi,
and rca-umb.
Click to expand changelog
- New input and output format: fodt (#4010). This is ODF’s “flat” representation of a text document: a single XML file instead of a zip package (ODT). It supports the same options as odt, including --reference-doc (which should be a zipped odt) and --link-images.
- Resolve keywords after loading a syntax definition (#11921, #11923). This fixes a 3.12 regression in --syntax-definition that was due to a change in skylighting. As the skylighting changelog indicates, users must now apply resolveKeywords after parsing a syntax definition.
- With --citeproc, we no longer extract particles from given and family names in structured CSL JSON or CSL YAML references (#11911). Thus, for example, family: de Gaulle should not create a non-dropping particle “de”; “de Gaulle” should be considered the integral family name. This is a behavior change that could affect some bibliography processing.
- Commonmark reader:
- Make task lists work in commonmark_x. Previously task_lists would not work if fancy_lists was enabled, for any commonmark variant.
- Markdown reader:
- Put alert after tip, etc. in classes (#11919). Some of the writers (gfm, docbook, asciidoc, rst) check for the admonition name as the first class, so the change putting alert first broke the output. (Regression from 3.12.)
- Don’t trim spaces in inline span. Previously we trimmed the space in e.g. [ test ]{.class}. This behavior has no good rationale, and it made it impossible to represent insertions and deletions properly.
- Make lookahead for setext header line more efficient.
- Docx reader:
- Keep bookmark when stripping caption label (#11918). This allows us to preserve internal links to figures.
- Add map of table styles to the reader environment.
- Fix double strikethrough being dropped (Kyohei Takahashi). w:dstrike was not parsed at all, so text marked with Word’s double strikethrough was read as plain text, with no indication that it had been struck out. Treat it as Strikeout.
- Keep spaces at the edges of tracked changes in the span (#11904, Raffaele Mancuso). This is important for tracking insertions/deletions.
- ODT reader:
- Don’t crash on a table with no rows.
- Don’t loop forever on cyclic style inheritance.
- Make getStyleFamily linear in the inheritance depth. A style whose family had to be inherited took time exponential in the chain length.
- Cap the number of spaces produced by text:s. text:c is unbounded in ODF, so <text:s text:c="200000000"/> let an 832-byte document allocate until the OOM killer stepped in.
- Keep the set of used anchors in the reader

I'm pleased to announce the release of pandoc 3.12,
available in the usual places:
Binary packages & changelog: https://github.com/jgm/pandoc/releases/tag/3.12
Source & API documentation: http://hackage.haskell.org/package/pandoc-3.12
This release focuses on performance. Here are some benchmarks showing
the improvement since pandoc 3.10.2:
There shoud be even more dramatic gains in image-heavy documents, because
of optimizations in ImageSize.
In addition to performance improvements, there are many other small
improvements and bug fixes. See the changelog for full details.
Most of the performance gains and and many of the bugs were found
with the help of Claude Fable.
API changes:
- Text.Pandoc.ImageSize: ImageType now derives Eq.
- Text.Pandoc.Sources: new functions takeWhileP, takeWhile1P.
- Text.Pandoc.Shared: new functions stringifyInlines,
compactifyTable. FromText constraint added to the signatures
of htmlAttrs and tagWithAttrs.
Other changes of note:
- -t xml now respects --standalone, and produces a
fragment (just the blocks) if it is not provided, like -t native.
- The default CSS now includes dark mode support.
Thanks to all who contributed, especially new contributors
Andonome, Clar Fon, Gaurav Vijay Jadhav, Robert Szarka,
Samuel Huang, Yusuf Efe, and zenor0.
Click to expand changelog
- Markdown reader:
- Make alert keywords case-insensitive (#11836, Hendrik Erz). In addition, the class alert is now added to the produced Divs.
- Fix stream position handling in base64DataURI.
- Cheaply reject bareURL before trying uri/emailAddress.
- Reset sourcepos in parseWithString' when parsing a block quote or list item. Otherwise it can happen that by the time parseWithString' is called, the position has already been set to the next file on the command line. Fixes an odd bug with rebase_relative_paths (#11888).
- rebase_relative_paths: recognize URLs with unknown schemes (#11858).
- Use takeWhile1P in the hot inline parsers str, code, enclosure, and mmdShortSubscript.
- Reset sourcepos in parseWithString' when parsing a block quote or list item (#11888). This ensures that rebase_relative_paths will see the right source file.
- Typst reader:
- Map form: "prose" citations to AuthorInText (#11846, Samuel Huang).
- Make the handler maps monomorphic by wrapping the handlers in newtypes with polymorphic fields (BlockHandler, InlineHandler).
- Store document labels in a Set instead of a list.
- In pInline, only perform the label-target check for ref elements, not for every inline element.
- Handle highlight as a mark span (#11879, Samuel Huang).
- Collapse citations around soft break (#11897).
- Handle block content in inline element bodies (#11881, Samuel Huang).
- Handle #par (explicit paragraph element).
- LaTeX reader:
- Support LaTeX3 (xparse) document commands (#7540). Support the features described in the LaTeX usrguide.
- Fix \qed to produce U+00A0 (nbsp) instead of BEL.
- Fix unescapeURL handling of escaped backslash.
- Require that
ewif names begin with “if”.
- Fix position off-by-one after ## in tokenizer.
- Fix doubled source positions in retokenizeComment.
- Make raw token capture O(1) per token.
- Make untokenize linear instead of quadratic.
- Fail macroDef fast on non-macro-defining commands.
- Peek at next token directly in peekTok instead of going through satisfyTok.
- Skip doMacros state update for non-macro tokens.
- Build command dispatch maps (inlineCommands, etc.) once per parse.
- Keep ASCII quotes when ligatures are disabled.
- Don’t discard state changes made in optional arguments.
- Keep nested conditionals balanced in \iftrue etc.
- Docx reader:
- Read ScreenTips as link titles (#11869, Robert Szarka).
- Use comment-id instead of id in AST for comments.
- ODT reader:
- Rewrite in monadic style. Net -994 lines. No changes to test output.
- Handle textProperties on paragraph styles (#2623). Previously these just got ignored, not applied to the paragraph’s text.
- HTML reader:
- Don’t require a closing tag for c

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-method option. This replaces (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).
- Make mathml the default math-method (#11751).
- Add --completion={bash,zsh,fish} (#8542, wzy). Make --bash-completion an 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 writerHTMLMathMethod field of WriterOptions to writerMathMethod.
- Markdown reader:
- Add a syntax (1@label) for resetting example list counter (#10940). This is needed often at the beginning of a chapter.
- MediaWiki writer:
- Put <nowiki> around possible URLs (#11834). Otherwise they get linkified automatically.
- Docx reader:
- Handle case where non-header rows come before header rows (#11833).
- Improve handling of tables with uneven rows (#11833).
- RTF Reader:
- Add support for nested tables (#11218, Alex).
- Typst reader:
- Remove handling of ‘block’ as an inline-level element (#11814).
- HTML reader:
- Handle pre without code (#11810). Preserve whitespace as nonbreaking spaces.
- ODT/OpenDocument writers:
- Support RTL text direction (#11301). RTL is now properly handled in these cases: dir: rtl (or ltr) in document metadata; an RTL lang in metadata (e.g. he, ar), unless overridden by dir; a dir attribute on a Div. Code blocks remain ltr regardless.
- Use style:language-complex rather than fo:language for RTL languages (#11301).
- Fix treatment of DefaultHighlighting (#11829).
- Docx writer:
- Initialize envLang from lang metadata (#11301). This ensures that setting lang will affect the whole document. Previously, setting lang to he was not sufficient to make the document RTL.
- JATS writer:
- Fix illegal use of p element inside p (#11809).
- 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 optHTMLMathMethod to optMathMethod. [API change]
- MSI installer: Fix upgrade detection for per-machine installations (#11827, Wrong-Code). Previou

I'm pleased to announce the release of pandoc 3.10.2,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.10.2
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.10.2
This release fixes some bugs, including a couple of regressions.
One relates to conversion of quotation marks in typst output; the
other fixes parsing of math containing ` ag`, `label`, or comments.
There is one new feature: a `typst-label` attribute on a Div,
Table, Figure, or Header will be used to construct a label
in typst output.
In addition, pandoc.wasm should now be useable with wasmtime.
No API changes, but bumpting third digit because of the `typst-label`
behavior change.
Thanks to all who contributed, especially new contributors Philipp Gillé
and gemmaro.
Click to expand changelog
- Markdown reader:
- Raw HTML: fix handling of void hr element (#11793).
- LaTeX writer:
- Omit empty caption on unnumbered tables (#11795).
- Emit accumulated footnotetext at the first available opportunity (#11773).
- Typst writer:
- Don’t alter curly quotes in strings, even with smart (#11788). This reverts commit 0484840.
- Make writer sensitive to typst-label attribute (#11794). If this attribute is set, the writer will output a label. (This overrides labels based on identifiers, when identifiers are present.)
- Typst template: rename horizontalrule to horizontalRule , so it matches the polyfill. (#11784, Ian Max Andolina).
- Text.Pandoc.Readers.HTML.TagCategories (unexported): export voidTags.
- epub.css: Add support for dark mode (k6G52m4Dz75W).
- WASM build: restore legacy exception handling, for compatibility with wasmtime (#11787).
- Use new release of asciidoc (fixing problems with row/colspans and footers in tables).
- Use new release of texmath (fixing problems with equations containing \tag, \label, or comments).
- MANUAL.txt: Correct Asciidoctor name casing (gemmaro, #11782).
- INSTALL.md: Update Fedora link to pandoc-cli package (#11798, Philipp Gillé).
- CONTRIBUTING.md: remove suggestion to submit Lua filters (#11800).
- Add doc/twenty-years-of-pandoc.md.
- Changelog - fix pandoc 0.1 release date.
- Add release-announcements.txt (scraped from pandoc-announce).

I'm pleased to announce the release of pandoc 3.10.1,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.10.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.10.1
This release contains many small improvements and bug fixes.
Some of the more notable ones are mentioned here (see the changelog
for details):
- t2t (Txt2Tags markup) is now an output format.
- It is now possible to use a defaults file without an
extension; pandoc will add the .yaml extension only if
no file exists with the name specified.
- The auto_identifiers extension may now be used with typst input.
(however, it is not enabled by default.)
- We now use '#divider()' (typst 0.15) for typst horizontal rules,
instead of defining our own horizontalRule function.
- It is now finally possible to force LaTeX to use a regular
floating table rather than a longtable, which is especially
important for two-column layouts (longtable does not
support them). One does this by adding the `float` class
to the table's attributes.
- starmath is now used instead of MathML for math in ODT.
This produces much better results and improves the editability
of equations.
- We now automatically enable auto_identifiers when a table of contents
is requested, since these require identifiers to link to.
- A new flake.nix allows use to use 'nix build' and 'nix run'
with pandoc.
API changes:
New module Text.Pandoc.Writers.Txt2Tags, exporting writeTxt2Tags,
also re-exported by Text.Pandoc.Writers.
Thanks to all who contributed, especially new contributors
Can H. Tartanoglu, Chirag Dhamange, Enrico Spinielli,
Robertas, Scott Talbert, Tobias Deiminger, luginf.
Click to expand changelog
- New output format t2t (Txt2Tags markup, https://txt2tags.org)) (luginf).
- New module Text.Pandoc.Writers.Txt2Tags, exporting writeTxt2Tags (loginf) [API change]. Also exported from Text.Pandoc.Writers.
- Change adding of .yaml extension in --defaults option (#11717). Previously it was always added if the specified filename lacked an extension. Now it is only added if there is no file with the original name. This facilitates using --defaults with bash/zsh <(..) or =(..).
- RST reader:
- Fix nested placeholder resolution for inline elements (#11753, Tobias Deiminger). (Regression from pandoc 3.6.)
- Treat undefined substitution references as plain text (#11727). This mirrors rst2html behavior.
- Markdown reader:
- Ordered sublists must start with 1, er equivalent, e.g. i (#11735). This brings the markdown parser in line with commonmark, and avoids a lot of unintended list starts. Note that ordered lists that are not sublists may still start with numbers other than 1.
- ODT reader:
- Don’t create Emph just because of changed font (#11691).
- RTF reader:
- Support multi-paragraph list items.
- Support legacy \pn/\pntext paragraph numbering (#11686).
- Docx reader:
- Improve horizontal rule detection (#11689).
- Key list numbering off abstractNumId, fixing numbering for restarted lists (#8367).
- LaTeX reader:
- Handle \hypertarget with one braced parameter (#7418).
- DokuWiki reader:
- Skip non-cell content after table row (#11739).
- Typst reader:
- Support auto_identifiers extension (#11041). The extension is available for the typst reader but is off by default; enable it with -f typst+auto_identifiers. The related gfm_auto_identifiers and ascii_identifiers extensions are also made available.
- Recognize divider() for horizontal rule (#11540).
- HTML reader:
- Fix unused variable warning in CI (#11704, Robertas).
- Strip language- from all classes, not just first (#11701). Also combine classes from both code and pre class if they are nested.
- Powerpoint writer:
- Keep tables and surrounding text on same slide (#11433, Chris Callison-Burch). Previously, when a slide contained bullet points before and after a table, content would be split across multiple slides or use a two-column layout that didn’t preserve the source order.
- Texinfo write

I'm pleased to announce the release of pandoc 3.9.0.2,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.9.0.2
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.9.0.2
This release just fixes a bad regression in the typst template.
Click to expand changelog
- Typst template: fix regression introduced in 3.9.0.1 (#11538).

I'm pleased to announce the release of pandoc 3.9.0.1,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.9.0.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.9.0.1
This is a bug-fix release, with no major new features or
API changes, but lots of small improvements. See the
changelog for details.
Thanks to all who contributed, especially new contributors
Agriya Khetarpal, Peter Briggs, Sidney Mau, and λx.x.
Click to expand changelog
- WASM GUI:
- Don’t block everything while pandoc.wasm loads.
- Fix bug with Unicode filenames (#11447).
- Catch errors loading pandoc.
- Docx reader:
- Recognize media inside textboxes (#11053, Raymond Berger).
- Properly handle media stored with packaged-rooted paths such as /media (#11518). This can be produced by the online version of Word. With this change, media stored at an absolute path will be stored with its original name and not given a SHA1-based name.
- Preserve non-textbox content when unwrapping textboxes (#11510, #6893, #11412, #5394, #9633). Treat text inside a textbox containing an image as a figure caption.
- Typst reader:
- Handle bibliography command (#11460). If this is present, a bibliography section is added to the document and the bibliography paths are added to bibliography in the metadata. This sets things up for using --citeproc.
- Textile reader:
- Handle block content in cells (#11455).
- Docx reader:
- Support w:gridBefore table row property (#11464, Jan Tojnar).
- LaTeX reader:
- Support \footnotemark and \footnotetext (#11450). These commands allow separating the footnote mark from its content, useful in tables, minipages, and other contexts where \footnote cannot be used directly.
- Support supertabular environment (#11523, bodigrim).
- ODT Reader:
- Fix relative linked images (#11369, Tuong Nguyen Manh).
- Recognize Preformatted_20_Text style Jan Tojnar This is used by LibreOffice, and we will switch to that as well.
- Add block smushing logic (Jan Tojnar).
- Support Preformatted Text style (#4841, Jan Tojnar).
- Markdown reader:
- Fix bug with lists_without_preceding_blankline (#11534).
- Typst writer:
- Don’t add a carriage return after \ for hard break (#11446). They are not necessary. Note that they can still be included if you use --wrap=preserve and add a newline in your source document.
- Improve handling of data: URIs in images. Instead of using an SVG with a link containing the data URI (the solution of #10460), we can now simply produce a bytes object with the requisite bytes. Typst figures out the format automatically.
- Fix escaping of quotes (#11463).
- Include alt attributes on images (mcanouil).
- Properly escape . after bracketed argument (#11511).
- Docx writer:
- Don’t depend on extractTarget from Docx reader.
- Fix section breaks with --top-level-division (#11482, #10578).
- EPUB writer:
- Add cover metadata for EPUB3 (#11479). This allows file managers to show cover thumbnails for EPUB3 files as well.
- Update allowed values for EPUB3 metadata identifier.scheme (#11481, Pascal Wagler).
- ODT writer:
- Rename inline source class to match LibreOffice (#3390, Jan Tojnar). Rename the text style we use to represent Code inlines from Source_20_Text to Source_Text. This is the same name LibreOffice Writer uses so it will be recognized by the Character Styles section of the Styles menu.
- Remove font size from inline source class (Jan Tojnar). This matches what LibreOffice Writer is doing. Also fixes literals inside headings being too small.
- Modernize Preformatted Text & Source Text styles (Jan Tojnar). Presumably, font-family-generic and font-pitch will allow to find a replacement on systems that do not have Courier New.
- Markdown writer:
- Fix rendering of alerts (#11479). We only properly handled the case where the alert started with a paragraph, but it can start with a list or other block type.
- Escape literal & that would trigger entity (#11490).
- HTML writer:
- Fo

I'm pleased to announce the release of pandoc 3.9,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.9
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.9
Starting with this release, pandoc can be compiled to WASM, making it
possible to use pandoc in the browser. A full-featured GUI interface
is provided at https://pandoc.org/app.
Defaults files may now be in either JSON or YAML, and variable
interpolation works now for the `defaults` field of a defaults file,
making it easier for defaults files to extend others.
--extract-media will now create a zip archive containing the media
(instead of a directory) if the specified path has a .zip extension.
A special class on headings can now be used to reset 'subsequent'
status for citations processed using --citeproc. This can be important
for some styles, which require that full citation information be given
for the first citation to a work in any given chapter.
The 'alerts' extension can now be used with pandoc's Markdown.
Support has been added for PDF standards and tagging via lualatex.
API changes:
- Text.Pandoc.Shared exports hasLineBreaks.
- The PandocHttpError constructor for PandocError now takes
a Text as argument instead of HttpException.
Thanks to all who contributed, especially new contributors Albert
Lei, Anton Melnikov, Chris Callison-Burch, Jacob Larkin, Yann
Trividic, You Jiangbin, benniekiss, and har7an.
Click to expand changelog
- Add support for compiling pandoc to WASM. (To build, make pandoc.wasm.) A stanza in cabal.project contains the necessary build modifications. We owe this almost entirely to TerrorJack, who created the original proof of context and came up with the necessary build flags and patches to some dependencies.
pandoc.wasm has almost all the power of regular pandoc. The main limitations is that it operates in a WASM sandbox and thus cannot use HTTP to fetch resources and cannot run system commands. As a result, JSON filters cannot be used, --embed-resources works only with resources that have been explicitly provided in the WASM sandbox, and PDFs cannot be produced (since that requires running external commands). However, Lua filters can be used, as long as they do not run system commands.
A JavaScript bridge module, wasm/pandoc.js, is provided; this handles the setup necessary to run pandoc.wasm in a browser.
In addition, a full-featured GUI interface is provided in the wasm subdirectory. make serve from that directory and it will run locally, or visit https://pandoc.org/app. Note that once the relevant code has been downloaded by the browser, it runs entirely in the browser, and the conversions never touch a server. The GUI was developed in interaction with Claude Code. This app includes a WASM version of Typst and can produce PDF output via Typst.
- Defaults files may now be either JSON or YAML (though a .yaml extension will still be assumed if the file has no extension). The structure of a JSON defaults file is isomorphic to that of a YAML defaults file.
- Variable expansion now works even for the defaults field of defaults files (#8024, Jacob Larkin).
- --extract-media will now create a zip archive containing the media (instead of a directory) if the path provided has a .zip extension.
- Processing with --citeproc is now affected by a reset-citation-positions class on headings. When the reset-citation-positions class is added to a top-level heading, --citeproc will reset position information at that point in the document. This is needed in order to ensure that the first citation in a chapter to a work that has been cited in a previous chapter will not be in abbreviated form.
- RST reader:
- Fix definition lists where term ends with - (#11323). This reverts some old code giving special treatment to lines ending in hyphens; I don’t understand why it was there, because rst2html does not seem to do this.
- HTML reader:
- Revert an earlier change that caused style tags in t

I'm pleased to announce the release of pandoc 3.8.3,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.8.3
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.8.3
This release adds three new input formats (asciidoc, pptx, and
xlsx) and one new output format (bbcode + variants).
It fixes a number of bugs (including some regressions in 3.8).
See the changelog for full details.
API changes:
+ New exported module Text.Pandoc.Readers.AsciiDoc,
exporting readAsciiDoc.
+ New module Text.Pandoc.Readers.Pptx, exporting readPptx.
+ New module Text.Pandoc.Readers.Xlsx, exporting readXlsx.
+ Text.Pandoc.Readers: Export readAsciiDoc, readXlsx, readPptx.
+ New module Text.Pandoc.Writers.BBCode, exporting
writeBBCode, writeBBCodeSteam, writeBBCodeFluxBB,
writeBBCodePhpBB, writeBBCodeHubzilla, writeBBCodeXenforo.
+ Text.Pandoc.Writers: Export writeBBCode,
writeBBCodeSteam, writeBBCodeFluxBB, writeBBCodePhpBB,
writeBBCodeHubzilla, writeBBCodeXenforo .
+ Text.Pandoc.Writers.Shared: Export insertCurrentSpansAtColumn,
takePreviousSpansAtColumn and decrementTrailingRowSpans.
+ Text.Pandoc.Shared: Export allRowsEmpty and
tableBodiesToRows.
Thanks to all who contributed, especially new contributors
Anton Antich, and Asliddinbek Azizovich, and James Barlow.
Click to expand changelog
- Add asciidoc as an input format (#1456).
- Add xlsx (Microsoft Excel) as an input format (Anton Antich). Each worksheet turns into a section containing a table.
- Add pptx (PowerPoint) as new input format (Anton Antich).
- Add bbcode as a new output format (#11242, reptee). Several variants of BBCode are also supported: bbcode_fluxbb (FluxBB), bbcode_phpbb (phpBB), bbcode_steam (Hubzilla), bbcode_hubzilla (Hubzilla), and bbcode_xenforo (xenForo).
- New exported module Text.Pandoc.Readers.AsciiDoc, exporting readAsciiDoc [API change].
- New module Text.Pandoc.Readers.Pptx, exporting readPptx (Anton Antich) [API change].
- New module Text.Pandoc.Readers.Xlsx, exporting readXlsx (Anton Antich) [API change].
- LaTeX reader:
- Revert \linebreak as LineBreak (#11272). \linebreak is more of a hint, it shouldn’t produce a hard break.
- Better handling of \makeatletter in parsing raw LaTeX (#11270).
- Fix spurious paragraph breaks in math environments (#11265, Emmanuel Ferdman). Previously, a math environment with extra space before the \end would get rendered with a blank line, which LaTeX treats as a paragraph break.
- Change type on rawLaTeXParser in Text.Pandoc.LaTeX.Parsing. The preparser doesn’t need to return a value.
- Fix rawTeXParser (#11253). Make macro expansion in raw LaTeX depend on the setting of the latex_macros extension. Previously macros were always expanded, even in raw TeX in markdown. In addition, there was previously a bug that caused content to be garbled in certain cases.
- Handle ifstrequal at a lower level, like the other if commands (#11253).
- Move ifstrequal, iftoggle, etc., which were misplaced in environments, to blockCommands, so these commands work properly.
- Docx reader:
- Handle REF link instruction (#11296, Ezwal).
- Check recursively for caption styles (Albert Krewinkel). The docx reader uses caption styles to identify figures and captioned tables. It now checks for known caption styles in the full styles hierarchy of a paragraph instead of just checking the style directly. This allows to recognize caption styles that are built on top of the basic caption style, as is sometimes the case in sophisticated styles.
- Markdown reader:
- Fix performance issue in links with ' (#10880).
- Typst reader:
- Handle document metadata and #title (jgm/typst-hs#80). Note that previously, the typst reader never returned document metadata. Now it does, even if the typst document does not contain a #title function that would result in actually printing the title block.
- Djot reader:
- Add Space elements (#11250). Previously we just got big Str elements with spaces included. But many p

I'm pleased to announce the release of pandoc 3.8.2.1,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.8.2.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.8.2.1
This is primarily a bug-fix release. There are no API changes.
The main motivation for the release is to fix a serious performance
regression with --citeproc and the default CSL style,
chicago-author-date.csl. This style was recently revised in a way that
took much longer for citeproc to parse. This version of pandoc is
built with citeproc 0.11, which fixes the performance regression.
One new feature (added by Albert Krewinkel) is that the Org reader now
parses parameter lists on unknown blocks, and also supports dynamic
blocks.
Thanks to all who contributed, especially new contributors
Emmanuel Ferdman, FoxChillz, mourino, and priiduonu.
Of special note:
- HTML reader: allow blank space between open and close `iframe`.
- RTF reader: improve hyperlink parsing (#11211).
- Org reader:
- Parse parameter lists on unknown blocks (#11188, Albert Krewinkel). The reader tries to parse the rest of the opening line of a block, e.g., `#+begin_myblock …`, as a parameters list. It first assumes that the parameters are in lisp-style (`:key value`), then alternatively tries to read python-style key-value pairs (`key=value`) and falls back to reading the entire remaining line as a single `parameter` attribute.
- Add support for dynamic blocks.
- Docx writer: properly handle nested comment spans (#8189, #6959, mourino).
- RST writer: Don’t use simple tables with RowSpans (#11214, Tuong Nguyen Manh).
- Typst writer: Escape open paren after non-space (#11210). This fixes an issue that occurs if an open paren comes right after e.g. `#strong[test]`.
- Typst template: ensure that title block is properly centered (#11221).
- LaTeX writer/template: small fix for unnumbered tables for compatibility with older LaTeX installations (#11201). Thanks to @priiduonu for the solution.
- MANUAL.txt: Fixed missing backtick (#11209, FoxChillz).
- Correct anchor references to `pandoc.text` module documentation (#11111, Emmanuel Ferdman).
- Fixed golden test regeneration in Docx reader test.
- Allow unicode-data 0.8.
- Use citeproc 0.11. This fixes a significant performance regression in pandoc 3.8, which was due to a rewrite of the default chicago-author-date.csl file. Performance with `--citeproc` is now on par with what we had in pandoc 3.7, even with the revised Chicago styles.

- MANUAL.txt: remove some redundancy (#11178, Reuben Thomas).

I'm pleased to announce the release of pandoc 3.8.2,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.8.2
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.8.2
This release fixes a regression in the typst template (since 3.8), which caused links to be omitted.
It also adds a new default Markdown extension, `table_attributes`, which allows attributes to be added to tables by putting them after the caption.
API change: Add `Ext_table_attributes` constructor to Extension.
Of special note:
- Markdown reader/writer: implement new `table_attributes` extension
(#10884). When `table_attributes` is enabled (as it is by default for
pandoc's Markdown), attributes can be attached to a table by
including them at the end of the caption. Previously the writer
would emit an identifier in this position, but the reader didn't
handle it. Now arbitrary attributes are allowed, and they work in
both the reader and writer.
- Typst writer: don't add superfluous semicolons (#11196).
Previously we added semicolons after inline commands not
followed by spaces, but mainly this was to deal with one issue:
the presence of a semicolon after an inline command, which
would be swallowed as a command separator (#9252).
This commits adopts an approach that should avoid so many
superfluous semicolons: it escapes semicolons that might come
right after a command.
- Typst template: fix 3.8 regression in which links disappear
(#11194). A template change in 3.8 added a show rule for links which
causes them to disappear except in special cases.
- Text.Pandoc.Parsing: rewrite `oneOfStrings` more efficiently.
- LaTeX writer: Fix strikeout in links (#11192, Tuong Nguyen Manh).
As in #1294 `\url` and `\href` need to be protected
inside an mbox for `soul` commands.
- Text.Pandoc.Extensions: Add `Ext_table_attributes` constructor for
`Extension` [API change].
* Use released texmath 0.13.0.1.
* Update FSF contact information in COPYING (#11183, Bensun Muite).

- MANUAL.txt: remove some redundancy (#11178, Reuben Thomas).

I'm pleased to announce the release of pandoc 3.8.1,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.8.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.8.1
This release introduces a few new features and fixes some bugs
and regressions. Of special note:
- New output format vimdoc (for Vim documentation).
- --syntax-highlighting now works as expected for typst output.
- New shorthands variable allows activating babel shorthands
in LaTeX/PDF output.
- Removed coloring for links in epub.css, so that the reader's
defaults will be used.
API changes:
- New module Text.Pandoc.Writers.Vimdoc, exporting writeVimdoc.
- Text.Pandoc.Parsing: new functions tableWithSpans,
tableWithSpans', toTableComponentsWithSpans, and
toTableComponentsWithSpans'.
- Text.Pandoc.Shared: new function removeLinks.
- Text.Pandoc.Highlighting: export functions formatTypstBlock,
formatTypstInline, styleToTypst (from skylighting).
Thanks to all who contributed, especially Tuong Nguyen Manh (who
has been working hard to improve table support) and new contributors
Raymond Berger and reptee.
Click to expand changelog
- New output format vimdoc (Vim documentation format) (#11132, reptee).
- [API change] Added module Text.Pandoc.Writers.Vimdoc, exporting writeVimdoc.
- Markdown reader:
- Improve superscript/subscript/inline note parsing (#8652). We do not allow inline notes to be followed by ( or [. Otherwise, we parse inline notes before superscripts. Also, the sub/superscript parsers have been adjusted so that they really exclude unescaped spaces (as they did not before, when the spaces occurred in nested inlines).
- Fix simple table alignment (#11136, Tuong Nguyen Manh). Take wide characters into account when determining the alignment.
- LaTeX reader:
- Ignore \pandocbounded (#11140).
- XML reader:
- Parse <MetaString> (#11137, massifrg).
- Typst reader:
- Add support for reading typst pagebreak (#11101, Raymond Berger). The pagebreak is parsed as a HorizontalRule inside a wrapper Div with class page-break.
- Docx reader:
- Handle figures in indented paragraphs (#11028).
- Change default for textwidth. This should only be used if sectPr is not found.
- Properly calculate table column widths (#9837, #11147). Previously we assumed that every table took up the full text width. Now we read the text width from the document’s sectPr.
- Use Tasty.Golden for Docx reader tests. This way we can update them with --accept.
- RST reader:
- Fix regression in simple table parsing (#11150).
- SkippedContent warning if table directive contains non-tabular content.
- Simple tables: leading space in a cell should not cause the contents to be parsed as a block quote (#11146).
- Parse :alt: on figure (#11140). Also give a better default if alt is not specified, using the stringified caption rather than the filename.
- Support col spans for simple tables (Tuong Nguyen Manh).
- Markdown writer:
- Improve handling of implicit figures (#11140). Allow implicit figures when alt text differs from caption (in this case, we use an image attribute to add the alt).
- Use approximate pipe tables when it’s the only option (#11128). If we have a table with row/colspans that can rendered as an approximate pipe table (without row/colspans), and no other table format is enabled that could render the table, we fall back to an “approximate” pipe table, with no row/colspans.
- RST writer:
- Ensure blank line before directives (#11162).
- Add col spans for simple tables (#10127, Tuong Nguyen Manh).
- OpenDocument writer:
- Add missing table elements (#10002, Tuong Nguyen Manh). Add missing header rows after the first one, footer rows as well as TableBody header rows.
- Docx writer:
- Fix regression (from 3.8) in highlighted code (#11156).
- Powerpoint writer:
- Handle single column (Tuong Nguyen Manh).
- Typst writer:
- Fix syntax highlighting (#11171, completes #10525). Previously the native typst highlighting was always use

I'm pleased to announce the release of pandoc 3.8,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.8
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.8
This release comes with many small improvements and a few larger ones.
Among the more visible changes:
+ A new input/output format xml, which exactly represents a pandoc
AST in a more easily human-readable form than JSON. The format is
documented in doc/xml.md, and schemas can be found in tools/pandoc-xml.*.
+ A new command line option --syntax-highlighting, which takes the
values 'none', 'default', 'idiomatic', a style name, or a path to
a theme file. --no-highlighting and --highlight-style are deprecated.
+ New extensions smart_quotes and special_strings for org mode.
These allow pandoc's parsing to more closely reproduce Emacs org-mode's
behavior.
+ The old compact_definition_lists extension has been removed.
API changes:
+ New modules Text.Pandoc.Readers.XML (exporting readXML) and
Text.Pandoc.Writers.XML (exporting writeXML).
+ Text.Pandoc.Extensions: added constructors Ext_smart_quotes,
Ext_special_strings; removed Ext_compact_definition_lists.
+ Text.Pandoc.App now exports versionInfo, a function that takes
three parameters that can be filled in by pandoc-cli.
+ Text.Pandoc.Parsing: tableWith and tableWith' now return
a list of lists of Blocks, allowing for multiple header rows.
+ Text.Pandoc.ImageSize: Add Point and Pica as constructors of
ImageSize. Add Avif constructor of ImageType.
+ Text.Pandoc.Class: CommonState is now opaque and does not support
its fields. To compensate for this, we now export several
new functions: getRequestHeaders, setRequestHeaders, getSourceURL,
getTrace.
Thanks to all who contributed, especially new contributors
Christopher Kenny, Erik Post, Repetitive, Reuben Thomas, Ryan Gibb,
Sean Soon, and massifrg.
Click to expand changelog
- Add a new input and output format xml, exactly representing a Pandoc AST and isomorphic to the existing native and json formats (massifrg). XML schemas for validation can be found in tools/pandoc-xml.*. The format is documented in doc/xml.md. Pandoc now defaults to this reader and writer when the .xml extension is used.
Two new exported modules are added [API change]: Text.Pandoc.Readers.XML, exporting readXML, and Text.Pandoc.Writers.XML, exporting writeXML. A new unexported module Text.Pandoc.XMLFormat is also added.
- Add a new command line option --syntax-highlighting; this takes the values none, default, idiomatic, a style name, or a path to a theme file. It replaces the --no-highlighting, --highlighting-style, and --listings options, which will still work but with a deprecation warning. (Albert Krewinkel)
- Create directory of output file if it doesn’t exist (#11040).
- Update --version copyright dates (#10961), and use a hardcoded string “pandoc” for the program name in --version, per GNU guidelines.
- Add smart_quotes and special_strings extensions (Albert Krewinkel). Currently these only affect org. Org mode makes a distinction between smart parsing of quotes, and smart parsing of special strings like .... The finer grained control over these features is necessary to truthfully reproduce Emacs Org mode behavior. Special strings are enabled by default, while smart quotes are disabled.
- Remove the old compact_definition_lists extension. This was neded to preserve backwards compatibility after pandoc 1.12 was released, but at this point we can get rid of it.
- Make -t chunkedhtml -o - output to stdout (as documented), rather than creating a directory called - (#11068).
- RST reader: Support multiple header rows (#10338, TuongNM).
- LaTeX reader:
- Support soft hyphens (Albert Krewinkel).
- Parse \minisec as unlisted level 6 headings (#10635, Albert Krewinkel).
- Support \ifmmode (#10915).
- Change handling of math environments (#9711, #9296). Certain environments in LaTeX will trigger math mode and can’t occur within math mode: 

I'm pleased to announce the release of pandoc 3.7.0.2,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.7.0.2
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.7.0.2
This release fixes some regressions in grid table rendering introduced
in 3.7. There are a few other nice improvements as well; see the
changelog for details.
Thanks to all who contributed, especially new contributor GHyman83.
Click to expand changelog
- RST writer:
- Don’t emit alignment markers in grid tables (#10857).
- Asciidoc writer:
- Add support for sidebars (GHyman83).
- LaTeX writer:
- Include alt option in \includegraphics (#6095).
- Markdown writer:
- Preserve figure attributes (Nikolay Yakimov, #10867). Fixes a regression introduced by 0d2114e, which caused the Markdown writer to ignore attributes on the figure if it has class or key-value attributes set.
- HTML writer:
- Use the ID prefix in the ID for the footnotes section (Benjamin Esham).
- Text.Pandoc.Writers.Shared:
- gridTable: fix (3.7) regression with missing cell alignments (#10853).
- gridTable: fix headings with colspans (#10855). If the heading contains a colspan, we still need to include information in the header line about the colspecs.
- gridTable: fix headerless tables. The top line should encode colspan information.
- Text.Pandoc.SelfContained:
- Fix handling of empty script element (#10862). Previously in this case the closing tag was dropped.
- Do not drop data- attributes in script tags (#10861).
- Lua subsystem (Albert Krewinkel):
- Add function pandoc.mediabag.make_data_uri (#10876). The function takes a MIME type and raw data from which it creates an RFC 2397 data URI.
- tools/update-lua-module-docs: fix handling of wikilinks (Albert Krewinkel).
- doc/lua-filters.md: add missing docs for pandoc.Caption (Albert Krewinkel).
- Require texmath 0.12.10.3, typst 0.8.0.1

I'm pleased to announce the release of pandoc 3.7,
available in the usual places:
Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.7
Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.7
- New command-line option --variable-json. This allows non-string
values (such as booleans or maps) to be given to template variables
on the command line.
- --pdf-engine will now accept groff as a value.
- Markdown and RST writers now allow row/colspans in grid tables.
In addition, table column widths will expand if needed to
contain text that can't be wrapped, avoiding the introduction
of unwanted whitespace.
- The four_space_rule extension now works for plain output.
- Roff formats now use the most portable syntax possible.
- Improved handling of inline TeX in Org-mode.
- In Lua filters, pandoc.read can now be used in "sandboxed"
mode, restricting file or network access, by passing in a
list of accessible files as a fourth parameter.
API changes:
- Text.Pandoc.Writers.Shared: new function delimited.
- Text.Pandoc.Writers.Shared: new version of gridTable with
changed parameters.
- Text.Pandoc.Class: new exported function sandboxWithFileTree.
Thanks to all who contributed, especially new contributors
Manolis Stamatogiannakis, Mohamed Akram, and Niklas Eicker.
Click to expand changelog
- Add new command-line option --variable-json (#10341). This allows non-string values (booleans, lists, maps) to be given to template variables on the command line.
- The --pdf-engine option can now take groff as a value.
- Markdown writer:
- Avoid spaces after/before open/close delimiters (#10696). E.g. instead of rendering x<em> space </em>y as x* space *y we render it as x *space* y.
- Handle row/colspans in grid tables, and expand cells when it isn’t possible to lay them out without breaking string of non-whitespace.
- Render a figure with Para caption as implicit figure (#10755).
- When falling back to a Div with class figure for a figure that can’t be represented any other way, include a Div with class caption containing the caption.
- Improve use of implicit figures when possible (#10758). When the alt differs from the caption, but only as regards formatting, we still use an implicit figure.
- Omit initial newlines in gfm math blocks to avoid an ugly blank line.
- Support the four_space_rule extension for plain output (#10813, Manolis Stamatogiannakis).
- RST writer:
- Handle row/colspans in grid tables, and expand cells when it isn’t possible to lay them out without breaking string of non-whitespace.
- Muse writer:
- Handle row/colspans in grid tables, and expand cells when it isn’t possible to lay them out without breaking string of non-whitespace.
- JATS writer:
- Fix escaping for writing-review-editing role (#10744).
- HTML writer:
- Remove trailing slash from default revealjs URL (#8749). This avoids a double slash in the URL’s path component.
- LaTeX writer:
- Make alignment work within multirow in tables (#10772).
- Typst writer:
- Support mark class on spans (#10747).
- Add equation label if math contains \label{..} (#10805).
- Roff format writers (man, ms):
- Use the most compatible form for roff escapes (#10716). For example, \(xy instead of \[xy]. This was the original AT&T troff form and is the most widely supported. The bracketed form causes problem for some tools, e.g. makewhatis on macOS. And emit e followed by an escape for a unicode combining accent rather than the form \[e aa], which works for groff but not e.g. on macOS’s man. This change affects Text.Pandoc.RoffChar, Text.Pandoc.Writers.Roff, and the Man and Ms writers.
- Docx writer:
- Ensure that figures and tables with custom styles are not dropped (#10705).
- Preserve Relationships for images from reference docx (#10759). This should allow one to include an image in a reference.docx and reference it in an openxml template.
- Don’t renumber rels (#10769). We used to renumber the Relationships so they didn’t conflict with the set of fixed R

Click to expand changelog
- Disable citations extension in writers if --citeproc is used (#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 (#10621).
- Give better position information when YAML metadata parsing fails with a YAML exception (#10231).
- Fixed escapedChar' parser (#10672). It should not accept escaped newlines.
- Remove some misguided list fanciness (#9865, #7778, cf. #5628). Previously we tried to handle things like commented out list items:
- one
<!--
- two
-->
- 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 (#10673).
- Ignore style tags in the body (#10643).
- LaTeX reader:
- Better handle comments/whitespace in option lists and includes (#10659).
- Support \newline, \linebreak.
- Docx reader/writer:
- Revert commit adding row heads (cbe67b9) (#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 #9495.
- LaTeX writer and template:
- Remove selnolig-langs (#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 (#6817).
- Use * for multirow width when no colwidth specified (#10685). Otherwise the multirow will be excessively wide.
- Protect \phantomsection (#10688, etclub).
- Markdown writer:
- Omit extra space after bullets (#7172). Those who want the old behavior can obtain it by using -t markdown+four_space_rule.
- Treat Emph [Emph ils]] as ils (#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 (#10650).
- Ensure that citation-style works as well as csl (#10661).
- Powerpoint writer:
- Avoid extra blank lines before author when there is no subtitle (#10619).
- JATS template:
- Fix typo in author prefix in article.jats_publishing template (#10622, Tiago-Manzato).
- Text.Pandoc.Parsing:
- Smart quote parsing: ignore curly quotes (#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 (#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 

Click to expand changelog
- Track wikilinks with a class instead of a title (Evan Silberman). Previously wikilinks were distinguished by giving them the title wikilink. Now that we have link attributes, it makes more sense to give them the class wikilink. This change affects all readers and writers that support wikilinks.
- DocBook reader:
- Handle title inside orderedlist (#10594). Also some other elements that allow title: blockquote, calloutlist, etc.
- Better handle informalequation (#10592, tombolano). Include id attribute.
- Better handle formalpara, example, and sidebar (#8666, tombolano). Include identifiers and titles in each case.
- Markdown reader:
- Simplify and fix normal citation parsing (#10584). This fixes a bug that causes some normal citations to be parsed as bracketed regular citations.
- ODT reader:
- Create Figure elements for images that are figures (#10567).
- Avoid producing spurious blockquotes in list items (#9505).
- Fix unwanted block quotes (#10575). Previously the reader created block quotes whenever a paragraph was marked indented (even though this just affects the first line). With this change we still generate block quotes for content that has an altered left margin, but not for indented paragraphs.
- Docx reader:
- Do not issue warning for comments with +styles (#10571, Stephen Reindl).
- LaTeX reader:
- Test {,re}newcommand arguments (#4470, Evan Silberman).
- Pod reader:
- Consume blanks after =encoding in pod reader (#10537, Evan Silberman).
- JATS writer:
- Add CRediT roles to JATS (Charles Tapley Hoyt and Jez Cope, #10152). Enable annotating author roles using the Contribution Role Taxonomy (CRediT) and export this information in conformant JATS.
- LaTeX writer/templates:
- Improve babel support (#8283). Previously we used the .ini files for every language, but for European languages these tend to provide inferior results to the .ldf files used by classic Babel. Currently Babel documentation recommends using the classic system for European languages written in Latin and Cyrillic scripts and Vietnamese. So the LaTeX writer and template now follow this guidance.
Main languages in the list of languages with good “classic” support are added to global documentclass options and will be automatically handled by Babel using the .ldf files.
If the main language is not in this list, the babeloptions variable will be set to provide=*, which will cause support to be loaded from the .ini file rather than an .ldf. So, for example, setting -V babeloptions='' with a polytonic Greek document will cause the .ldf support to be used instead of the .ini.
The default setting of this variable can be overwritten, but in most cases the default should give good results.
- Allow csquotesoptions to be specified.
- Fix indentation bugs in font-settings.latex.
- Docx writer:
- Repeat reference doc’s sectPr for each new section (#10577). Previously we were only carrying over the reference doc’s sectPr at the end of the document, so it wouldn’t affect the intermediate sections that are now added if --top-level-division is chapter or part. This could lead to bad results (e.g. page numbering starting only on the last chapter).
- Create section divisions with --top-level-division=part (#10576).
- Improve title style in reference.docx; base Author and Date on Title; remove condensed spacing (Andrew Dunning, #10581).
- Typst writer:
- Brace tables with typst:no-figure and typst:text attributes (#10563, Gordon Woodhull).
- Ms writer:
- Fix escaping of - (#10536). - should now be escaped in man output but not in ms output (where \- is a unicode minus sign).
- HTML styles: fix style of hr so it works when printed (#10535, Hendrik Erz). Previously background-color was used to style the hr, but this gets ignored when printing. This commit uses border-top instead.
- Text.Pandoc.Shared:
- Handle <abbr> as a span-like inline in htmlSpanLikeElements (#5793, Evan Silberman).
- Text.Pandoc.MediaBag:
- Prefer MIME type when determining 

- New output format: pod (Evan Silberman). Pod (“Plain old documentation”) is a markup languaged used principally to document Perl modules and programs.
- New reader module Text.Pandoc.Readers.Pod, exporting readPod [API change].
- Docx reader:
- Support row heads in tables (#9495). Reader: When w:tblLook has w:firstColumn set (or an equivalent bit mask), we set row heads = 1 in the AST.
- Read table styles as custom styles when styles extension is enabled (#9603).
- HTML reader:
- Add size information for font awesome SVG icons (#10134). If the icon has class fa-fw or fa-w16 or fa-w14, we add a width attribute to prevent the icon from appearing full-width in PDF or docx output.
- Djot reader:
- Use a Span with class “mark” rather than “highlighted” for highlighted text, for consistency with the other pandoc readers and writers.
- mandoc reader:
- Add mdoc St for C23 (Evan Silberman).
- RST reader:
- Fix handling of underscores (#10497). Fixes a a regression introduced in 3.6.
- Docx writer:
- Support row heads in tables (#9495). Writer: set w:firstColumn in w:tblLook when there are row heads. (Word only allows one, so this is triggered by any number of row heads > 0.)
- Djot writer:
- Render a Span with sole class “mark” as highlighted text.
- Asciidoc writer:
- Don’t emit the class in a span if it’s just “mark” (#10511). The “mark” class is used for highlighting, and Asciidoc treats bare #...# with no attributes as highlighted text.
- Improve escaping (#10385, #2337, #6424).
- EPUB v2 writer:
- Fix cover image (#10505). This is a regression introduced in 3.6.
- Typst writer:
- Fix handling of pixel image dimensions (#9945). These are now converted to inches as in the LaTeX writer.
- Improve error message given when users specify asciidoc as input format (#8416, Santiago Zarate).
- Allow random 1.3.
- Use texmath 0.12.8.13 (typst improvements).
- lua-filters.md: document system.os return values (#10523).
- MANUAL.txt:
- Improve manual’s coverage of custom styles.
- Replace LibreOffice PDF documentation link to latest so it links to the latest major release rather than a specific major release (which there are two of every year) (Stéphane Guillou).
- Improve links and descriptions for odt, opendocument (#10518).

- Allow YAML bibliographies to be arrays of references (#10452). Previously, they had to be YAML objects with a references key.
- Change --template to allow use of extensionless templates (#5270). The intent is to allow bash process substitution: e.g., --template <(echo "foo"). Previously pandoc always added an extension based on the output format, which caused problems with the absolute filenames used by bash process substitution (e.g. /dev/fd/11). Now, if the template has no extension, pandoc will first try to find it without the extension, and then add the extension if it can’t be found. So, in general, extensionless templates can now be used. But this has been implemented in a way that should not cause problems for existing uses, unless you are using a template NAME.FORMAT but happen to have an extensionless file NAME in the template search path.
- Allow --shift-heading-level-by=-1 to work in djot in the same way it works for other formats (with the top-level heading being promoted to metadata title) (#10459). This needed special treatment because of the way djot surrounds sections with Divs.
- RST reader:
- Handle explicit reference links (#10484, Evan Silberman). This case was missed when changing the reference link strategy for RST to allow a single pass. (It is a regression in pandoc 3.6.)
- Markdown reader:
- Use T.P.URI’s pBase64DataURI in parsing data URIs (#10075, Evan Silberman and John MacFarlane).
- More efficient base64 data URI parsing (#10075, Evan Silberman and John MacFarlane). This should yield dramatic performance improvements for markdown documents containing large data URIs in images.
- HTML reader:
- Don’t canonicalize data: URIs (#10075). It can be very expensive to call network-uri’s URI parser on these.
- LaTeX reader:
- Handle figure* environment as a figure (#10472).
- MediaWiki reader:
- Allow empty quoted attributes (#10490).
- Allow cells starting with + (#10491).
- Textile reader:
- Improve parsing of spans (#9878). The span needs to be separated from its surroundings by spaces. Also, a span can have attributes, which we now attach.
- Inline constructors shouldn’t trigger if closer is preceded by whitespace (#10414).
- Docx writer:
- Put chapters in separate sections, and restart footnotes by section by default (#2773). The main effect of this change is that when --top-level-division=chapter is used, chapters will start on a new page and footnote numbering will restart for each chapter. Both of these defaults can be overridden in the reference.docx.
- Use styleIds not styleNames for Title, Subtitle, etc. (#10282). This fixes a regression introduced in pandoc 3.5. This change affects the default openxml template as well as the OpenXML writer.
- Markdown writer:
- Avoid collapsing of initial/final newline in markdown raw blocks. This makes it easy to write a filter that adds extra blank lines before certain elements (#10477).
- Mediawiki writer:
- Escape line-initial characters that would otherwise be interpreted as list starts (#9700).
- LaTeX writer:
- Properly handle boolean value for csquotes variable (#10403).
- Use displayquote for block quotes with csquotes (#10456).
- HTML writer:
- Avoid calling parseURIString for data URIs (#10075). This was done to determine the “media category,” but we can get that directly from the mime component of data: URIs.
- Typst writer:
- Properly handle data URIs in images (#10460).
- LaTeX/Beamer templates:
- Fix default.beamer nocite location (Thomas Hodgson). It must be inside a frame or it is ignored (#10465).
- Move nocites from LaTeX preamble to body (#10461, Thomas Hodgson). Putting \nocite in the preamble works only with biblatex.
- Text.Pandoc.Parsing:
- Correct example in comment on charsInBalanced (Evan Silberman).
- Text.Pandoc.Error:
- Mention typst in rendering PandocUnknownWriterError for pdf (Evan Silberman).
- Text.Pandoc.MediaBag:
- insertMedia: fast path for data URIs. Avoid the slow URI parser from network-uri on large data URIs (#10075).

- Add mdoc as input format (Evan Silberman). This change introduces a reader for mdoc, a roff-derived semantic markup language for manual pages. This reader has been developed almost exclusively against mandoc’s documentation and implementation of mdoc as a reference, and the real-world manual pages tested against are those from the OpenBSD base system. Of ~3500 manuals in mdoc format shipped with a fresh OpenBSD install, 17 cause the mdoc reader to exit with a parse error. Any further chasing of edge cases is deferred to future work.
- New module: Text.Pandoc.Readers.Mdoc, exporting readMdoc [API change].
- Issue warnings for duplicate YAML metadata keys (#10312).
- Ensure that --sandbox affects --embed-resources. Previously it did not (contrary to what was implied by the manual), which means that an image with URL /etc/passwd would leak an encoded version of that file to HTML output with --self-contained or --embed-resources, even if --sandbox was used. Thanks to Samuel Mortenson for pointing out the issue.
- Text.Pandoc.App.OutputSettings: add sandbox' function. This computes the sandboxed files from Opt and avoids code repetition.
- Docx reader:
- Parse index references as empty spans with attributes (#10171). Attributes included are entry, and optionally bold, italic, yomi, see.
- Don’t create multiple paragraphs for title or subtitle (#10359). If there are multiple paragraphs with Title or Subtitle style, use only the first for metadata.
- Handle case where Zotero itemData has different id from the citationItem id. In this case we use the citationItemId in the bibliography as well, overriding the referenceId in the itemData (#10366).
- LaTeX reader:
- Put parsed minipage in specially marked Div (#10266).
- HTML reader:
- Parse footnotes defined by dpub-aria roles (#5294).
- MediaWiki reader:
- Fix indented tables with caption (#10390).
- Fix parsing of col/rowspan (#6992).
- Typst reader:
- Avoid generating empty paragraphs.
- Support underparen, overparen.
- Fix #quote attribution. If attribution is not present, don’t print the -- (#10320).
- Fix typo in unicode code point for em dash (see #10320).
- Commonmark reader:
- implicit_figures should check for empty caption and not produce an implicit figure in this case (#10429).
- RST reader:
- Use a new one-pass parsing strategy. Instead of having an initial pass where we collect reference definitions, we create links with target ##SUBST##something or ##REF##something or ##NOTE##something, and resolve these in a pass over the parsed AST. This allows us to handle link references that are not at the top level (#10281).
- Ignore newlines in URL in explicit link (#10279).
- Handle block level substitutions.
- Support :file: on raw directive (#8584).
- Implement option lists (#10318).
- Avoid putting metadata in Para (#7766). Create MetaInlines when possible, just as with markdown input. MetaBlocks is still used when there are multiple paragraphs or non-paragraph content. This change also affects field lists.
- Fix linked substitutions (#6588). E.g. |Python|_.
- Support inline anchors (#9196).
- Explicit links define references (#5081). For example, Go to `g`_ `g <www.example.com>`_. should produce two links to www.example.com.
- EPUB writer:
- Use standardized filename for cover image instead of the original name (#10404). This avoids problems with e.g. filenames containing spaces.
- Markdown writer:
- Issue INFO warning when not rendering table, e.g., when raw_html is disabled and the table can’t be fit into a supported markdown table format (#10407).
- Respect empty LineBlock lines in plain output (Evan Silberman). The plain writer behaved as a markdown variant with Ext_line_blocks turned off, and so empty lines in a line block would get eliminated.
- LaTeX writer:Ensure that beamer footnotes go on frame, not column (#5769).
- HTML writer:
- Unwrap empty incremental divs (#10328, Albert Krewinkel). Divs are unwrapped if the only purpose of the div seems to be to control whet

- Add command-line options --list-of-figures/--lof and --list-of-tables/--lot (#10029, Akash Patel). Only docx, latex, and context are affected by these options currently. Setting the lof and lot variables will also work for the formats that are currently supported.
- Defaults files: interpolation of environment variables now works for to and from fields (#8024). This is needed because these files can contain paths of custom readers/writers.
- Docx reader:
- Reset lists after headers in same list numId (#10258). To accomplish this, we add a Heading constructor to BodyPart and include on it all the information list items have.
- DocBook reader:
- Parse id, class, and tabstyle on tables (#10181, Erik Rask). Add parsing of id (xml:id), class, and tabstyle XML attributes for table and informaltable in the DocBook reader. The tabstyle value is put in the ‘custom-style’ attribute.
- Dokuwiki reader:
- Be more forgiving about misaligned lists, like dokuwiki itself (#8863).
- Improve blockquote parsing in dokuwiki. Allow for quoted code blocks.
- Enable smart extension.
- Properly parse -- and --- as dashes.
- Fix block quote behavior (#6461). Blockquotes are not really block containers in DokuWiki; the lines are interpreted literally (so, e.g., you can’t start a list), and line breaks are added at the ends.
- EPUB reader:
- Fix links to other files in the EPUB, making them internal links to a fragment derived from the filename (#10207). There was already code to handle links like #foo, but not to handle links like ch0001.html#foo.
- LaTeX reader:
- Add em, ex, px, mu to list of units for dimension args (#10212).
- ANSI writer:
- Fix subscripts (Evan Silberman).
- DokuWiki writer:
- Don’t emit <HTML> tags (#7413). The use of these tags is now strongly discouraged for security reasons, and will be removed. We previously used them as a fallback for lists that could not be represented using DokuWiki syntax, e.g. ordered lists with fancy numbers or lists with multiple blocks in their items. We also used them for block quotes with multiple blocks as their contents. We now use the <WRAP> syntax (from the optional WRAP plugin) to handle lists with multiple blocks as their contents. A new method of handling block quotes with complex contents has the side benefit of also handling nested block quotes, which weren’t supported before. <HTML> and <html> tags are only for raw HTML blocks and inlines, and only if the raw_html extension is enabled. (It is now a valid extension for dokuwiki, though off by default.)
- Docx writer:
- Support --list-of-figures and --list-of-tables (or lof and lot variables) (Akash Patel).
- HTML writer:
- Don’t emit missing title/lang warnings if templates does not contain the pagetitle or lang variables respectively (#9370).
- LaTeX writer:
- Better fix for lists in definition lists (#10241). In commit we added an empty \item[] to the beginning of a list that occurs first in a definition list, to avoid having one item on the line with the label. This gave bad results in some cases (#10241) and there is a more idiomatic solution anyway: using \hfill.
- Avoid error on refs div with empty citations (#10185). If there are no citations, don’t emit an empty CSLReferences environment.
- RST writer:
- Change bullet list hang from 3 to 2. This accords with the style in the RST reference docs.
- Handle cases where indented context starts with block quote (#10236). In these cases we emit an empty comment to fix the point from which indentation is measured; otherwise the block quote is not parsed as a block quote. This affects list items and admonitions.
- Don’t enclose the list table in a .. table::; this leads to doubled captions (#10226).
- Fix alignment of list table items corresponding to cells (#10227).
- JATS template:
- Support floats-group (Albert Krewinkel, see #10196). The content of the floats-group variable is now rendered in a <floats-group> element when using the publishing or archiving tag sets.
- LaTeX and Beamer t

- New output format: ansi (for formatted console output) (Evan Silberman). Most Pandoc elements are supported and printed in a reasonable way, if not always ideally. This version does no detection of terminal capabilities, nor does it fall back to different output styles for less-capable terminals.
- Add command line options --table-caption-position and --figure-caption-position. These allow the user to specify whether to put captions above or below tables and figures, respectively. The following output formats are supported: HTML (and related such as EPUB), LaTeX (and Beamer), Docx, ODT/OpenDocument, Typst.
- Change default --pdf-engine via HTML to WeasyPrint (#10142). wkhtmltopdf is deprecated. weasyprint is the easiest-to-install, maintained alternative. For better results, one might prefer pagedjs-cli.
- Org reader:
- Fix parsing of src blocks with an -i flag (#10071, Albert Krewinkel). Tabs are now preserved in the contents of src blocks if the the block has the -i flag.
- RTF reader:
- Handle images inside shp contexts (#10145).
- RST reader:
- Improve simple table support (#10093). Multiline rows occur only when the first cell is empty; we were previously treating lines with any empty cell as row continuations. In addition, we no longer wrap multiline cells in Para if they can be represented as Plain. This is consistent with docutils behavior.
- LaTeX reader:
- Math environments don’t have bracketed options (#10160).
- Parse nested tabular environments (#4746).
- Typst reader:
- Change how “block” elements are handled. Previously they were always parsed as divs. But actually they can occur in some “inline” contexts. Now we first try to parse them as inlines, and only as blocks if that fails. A surrounding Div or Span element is added only if there is an identifier.
- HTML reader:
- Only parse main element’s contents (if present) (#10140). If main has an id or class, we include a div with that id or class; otherwise just the contents.
- Read TeX annotation in MathML content if present (#9971).
- Better handle KaTeX-generated math (#9971). KaTeX emits the mathml followed by a span with an HTML fallback. Previously pandoc was converting both. We now ignore the HTML fallback span, marked with class katex-html.
- New module: Text.Pandoc.Writers.ANSI [API change] (Evan Silberman).
- Docx writer:
- Add “SuppressAuthor” and “AuthorOnly” to citationMode when +citations is used (thomjur).
- Support custom-style attribute for docx table (Sebbones).
- Support --number-offsets.
- Make table/figure rendering sensitive to caption position settings.
- OpenDocument writer:
- Make table/figure rendering sensitive to caption position settings.
- Typst writer/template:
- Implement figure caption positions by triggering a show rule in the default template, which determines caption positions for figures and tables globally.
- Don’t include trailing semicolon after @ style citations with suffixes (#10148).
- Template: move header-includes before show doc (#9996, Gordon Woodhull).
- LaTeX writer:
- Make table/figure rendering sensitive to caption position settings (#5116).
- Preserve locator labels with --natbib (#10057).
- HTML writer/template:
- Make <figcaption> placement sensitive to caption position settings. For tables, <caption> must be the first element, and positioning is determined by CSS, for here we set a variable which the default template is sensitive to.
- Use makeSectionsWithOffsets for writerNumberOffsets, instead of the old, inefficient code.
- Don’t add doc-biblioref role to every link in a citation; only to links to the bibliography (#10156).
- Add data- when rendering label attribute (#10048).
- Markdown writer:
- Avoid emitting markdown caption if table has fallen back to raw HTML, which will then contain a <caption> tag (#10094).
- Make math sensitive to tex_math_gfm extension (#9121). This means that in GFM output, the “new style” math will be used by default, e.g.
$`x=y`$

```math
x = y
```

To defeat this and get the 

- New cli option: --link-images. This causes images to be linked rather than embedded in ODT.
- Allow --number-sections to take an optional true|false argument.
- RTF reader:
- Handle \*\shppict without dropping image (#10025).
- TWiki Reader:
- Recognize WikiWords as internal links (#9941).
- Avoid partial function.
- Typst reader:
- Ignore ‘pad’ and just parse its body (#9958).
- Use typst 0.5.0.5. Fixes parsing of equations like $1.$.
- Docx writer:
- Fix regression with nested lists (#9994). The bug affects e.g. ordered lists with bullet sublists; after the sublist the top-level list reverts to bullets instead of being properly numbered. This is a regression introduced in version 3.2.1.
- BibTeX writer:
- Ensure that “literal” names are enclosed in braces (#9987).
- Man writer:
- Use default middle header when metadata does not include header (#9943). This change causes pandoc to omit the middle header parameter when header is not set, rather than emitting "". The parameter is optional and man will use a default based on the section if it is not specified.
- HTML templates: don’t load polyfill (#9918). This was added in a period when MathJaX required polyfill. MathJaX no longer recommends this and polyfill should no longer be necessary on any reasonably modern browser.
- Translations:
- Add ua.yaml (Jens Oehlschlägel).
- Add a script (tools/update-translations.py) and Makefile target (update-translations) to update translation data automatically from babel and polyglossia upstream (Stephen Huan).
- Use this script to update language data, increasing the number of languages we cover (Stephen Huan). Fix a few small bugs in existing translations.
- Fix some mistakes with Japanese language code (#9938). In several places we were mistakenly assuming that the BCP 47 code for Japanese language was jp. It is ja.
- Text.Pandoc.Options:
- New field in WriterOptions: writerLinkImages [API change] (#9815).
- Text.Pandoc.App.Opt:
- New field in Opt: optLinkImages [API change] (#9815).
- Lua subsystem:
- Keep lpeg and re as “loaded” modules (Albert Krewinkel). The modules lpeg and re are now treated as if they had been loaded with require. Previously the modules were only assigned to global values, but could be loaded again via require, thereby allowing to use a system-wide installation. However, this proved to be confusing.The old behavior can be restored by adding the following lines to the top of Lua scripts, or to the init.lua in the data dir.
debug.registry()['_LOADED'].lpeg = nil
debug.registry()['_LOADED'].re = nil

- pandoc-cli: Include pandoc copyright in Lua version info (Albert Krewinkel).
- pandoc-cli: Refer printing of version info to the Lua interpreter (Albert Krewinkel). The Lua interpreter no longer terminates when called with -v or --version arguments, thus improving compatibility with the default lua interpreter program.
- Avoid partial functions in JATS reader, DocBook writer, Haddock reader.
- Allow tls 2.1.x.
- MANUAL.txt:
- Make documentation of extensions clearer (#9060).
- Fix section level for two Extensions entries.
- lua-filters.md: Partially autogenerate docs for module pandoc (Albert Krewinkel). The documentation system isn’t powerful enough to generate the full documentation automatically.

- Change to --file-scope behavior (#8741): previously a Div with an identifier derived from the filename would be added around the contents of each file. This caused problems for “chunking” files into chapters, e.g. in EPUB. We no longer add the surrounding Div. This cooperates better with chunking. Note, however, that if you have relied on the old behavior to link to the beginning of the contents of a file using its filename as identifier, that will no longer work.
- Markdown reader:
- Allow repeated labels in numbered example lists. Previously if you tried to use the same label as an earlier example list item, you’d get a new number, not the old one, and references to the label would go to the second occurrence. Now an existing label will be reused, and no new number will be generated. Caveat: this only works reliably when the re-used example list item occurs by itself in a list, or occurs in a list of previously used example list items that occur in exactly the same order as previously.
- Fix normalCite so it doesn’t consume past a closing ] boundary (#9710). This was causing an exponential performance bug on long lists of links containing potential emphasis characters.
- Generalize inlinesInBalancedBrackets to inBalancedBrackets, with a parameter for the inner parser.
- Auto-close unclosed divs (#9635). This applies to both fenced and HTML-ish varieties. Otherwise we face an exponential performance problem with backtracking. A warning is issued when a div is implicitly closed.
- RST reader:
- Fix figclass and align annotations for figures (#7473, Gokul Rajiv).
- LaTeX writer:
- Use polytonicgreek instead of polutonikogreek with babel (#9698). polutonikogreek is outdated. Also recognize both in the LaTeX reader.
- Improve treatment of math inside soul commands (#1294, #5529). soul commands (ul, hl, st) are very fragile and the math must be handled specially.
- LaTeX reader:
- Fix over-eager macro expansion in conditionals (#9676).
- Parse flalign, flalign* math environments (#9679). We parse these as Math elements with an aligned environment. Semantically it’s not exactly the same, but better than falling back to raw LaTeX.
- LaTeX template: add titlegraphicoptions variable (#9207, Guilhem Saurel).
- Docx reader:
- Issue warning rather than error when we can’t parse EndNote citations (see #8433).
- Fix anchor in header after anchor (#9626, mbracke).
- RTF reader:
- Don’t try to handle non-default code pages (#9683). Emit a warning instead.
- OpenDocument writer:
- Implement custom-style for spans (#9657).
- Typst writer:
- Add blank line in definition lists with multiple definitions (see #9704).
- Property output (#9648, Gordon Woodhull). The Typst writer will pass on specially marked attributes as raw Typst parameters on selected elements. This allows extensive customization using filters. A separate document (doc/typst-property-output.md) has been added that provides extensive documentation and examples of the use of this feature.
- Markdown writer:
- Don’t try to align columns in pipe tables with lines greater than COLUMNS. The alignment just reduces readibility when the lines soft wrap.
- Don’t use raw_attribute syntax for raw blocks, unless there is no other option (see #9677). Macros in a raw_attribute block don’t get interpreted when it is read again by pandoc’s markdown reader.
- ConTeXt writer:
- Replace depreciated \sc with \setsmallcaps (#9518, James P. Ascher).
- Docx writer:
- Use conventional styles/indents for Word bullet lists (#7280).
- reference.docx:
- Use current standard Word theme (#7280). This includes using the sans-serif font Aptos instead of the serif font Cambria, and default colors for headings.
- Remove duplicate DefaultParagraphFont in styles.xml.
- New module Text.Pandoc.Transforms [API change] (Albert Krewinkel). This module exports the following functions which were formerly exported from Tetx.Pnadoc.Shared: headerShift, filterIpynbOutput, eastAsianLineBreakFilter, as well as some functions 

- Org reader:
- Fix treatment of id property under heading (#9639).
- DocBook reader:
- Add empty title to admonition div if not present (#9569). This allows admonition elements (e.g. <note>) to work with gfm admonitions even if the <title> is not present.
- DokuWiki reader:
- Link text cannot contain formatting (e.g., // is not italics) (#9630).
- An explicitly empty link text ([[url|]]) works the same as an omitted link text (#9632).
- Typst reader:
- Support Typst 0.11 table features: col/rowspans, table head and foot (#9588).
- Parse cell col/rowspans.
- CSLJson writer:
- Put $ or $$ around math in csljson output (#9616).
- ConTeXt writer:
- Fix options order with \externalfigure. The dimensions should come beforeafter the class if both are present.
- Typst writer:
- Put label after Span, not before. Labels get applied to preceding markup item.
- Support Typst 0.11 table features (#9588): colspans, rowspans, cell alignment overrides, relative column widths, header and footer, multiple table bodies with intermediate headers. Row heads are not yet supported.
- The default typst template has been modified so that tables don’t have lines by default. As is standard with pandoc, we only add a line under a header or over a footer. However, a different default stroke pattern can easily be added in a template.
- More reliable escaping in inline [..] contexts (#9586). For example, we need to escape [\1. April] or it will be treated as an ordered list.
- Handle unnumbered on headings (#9585).
- LaTeX writer:
- Fix math inside strikeout (#9597).
- Text.Pandoc.Writers.Shared:
- Export isOrderedListMarker [API change].
- Change lhs tests so they don’t use --standalone. This will avoid test failures due to minor changes in skylighting versions, e.g. #9589.
- Use latest texmath, typst.
- Require pandoc-lua-marshal 0.2.6 (#9613, Albert Krewinkel). Fixes an issue arising when the value of content properties on BlockQuote, Figure, and Div elements was an empty list.
- Update lua-filters.md (#9611, Carlos Scheidegger).

- Markdown reader: Fix bug with footnotes at end of fenced div (#9576).
- LaTeX reader:
- Improve tokenization of @ (#9555). Make tokenization sensitive to \makeatletter/\makeatother. Previously we just always treated @ as a letter. This led to bad results, e.g. with the sequence \@. E.g., a\@ b would parse as “ab” and a\@b as “a”.
- Make withRaw work inside parseFromToks (#9517). This is needed for raw environments to work inside table cells.
- Better handling of table colwidths (#9579). Previously the parser just failed if the column width specified in p{} wasn’t a multiple of \linewidth. This led to cases where content was skipped.
- Typst writer:
- Add ‘kind’ parameter to figures with tables (#9574).
- Avoid unnecessary box around image in figure (#9236).
- Omit width/height in images unless explicitly specified (#9236). Previously we computed width/heigth for images that didn’t have size information, because otherwise typst would expand the image to fit page width. This typst behavior has changed in 0.11. This change fixes a bug in which images would sometimes overflow page margins, depending on their intrinsic size.
- Don’t add hard-coded inset to tables (#9580). Instead, set this globally in the default template, allowing it to be customized.
- LaTeX template: Fix block headings support for unnumbered paragraphs (#9542, #6018, Oliver Fabel).
- HTML templates: Replace polyfill provider (#9537, @SukkaW). Replace polyfill.io with cdnjs.cloudflare.com/polyfill. polyfill.io has been acquired by Funnull, and the service has become unstable.
- Korean translations: delete colon in translation for ‘to’. This was invalid YAML, and not desired anyway, since a colon is added.
- Use latest commonmark, commonmark-extensions. This fixes a 3.12 regression in parsing of commonmark/gfm autolinks (jgm/commonmark-hs#151).
- Depend on djot 0.1.1.3, which fixes a serious parsing bug affecting regular paragraphs after lists.
- Depend on latest skylighting, skylighting-core, typst-hs, texmath.
- MANUAL.txt: Change broken link to IDML cookbook (#9563).

- Docx reader:
- Ensure that table captions are counted (#9518).
- Detect caption by style name not id (#9518). The styleId can change depending on the localization.
- Avoid emitting empty paragraph where caption was.
- Markdown reader: fix regression in link parsing with wikilinks extensions (#9481). This fixes a regression introduced in 3.1.12.
- Org reader/writer: support admonitions (#9475).
- Org writer: omit extra blank line at end of quote block.
- Typst writer: ensure that -, +, etc. are escaped at beginning of block (#9478). Our recent relaxing of escaping (#9386) caused problems for things like emphasized - characters that were rendered using #strong[-]#. This now gets rendered as #strong[\-].
- LaTeX writer: fix bug when a language is specified in two different ways (#9472). If you used lang: de-DE but then had a span or div with lang=de, the preamble would try to load ngerman twice, leading to an error. This fix ensures that a language is only loaded once.
- Docx writer: Don’t copy over footnotePr in settings.xml from reference.docx (#9522).
- EPUB writer: omit EPUB2-specific meta tag on EPUB3 (#9493). This caused a validation failure in epubs with cover images.
- Lua: avoid crashing when an error message is not valid UTF-8 (Albert Krewinkel).
- Text.Pandoc.SelfContained:
- Add role="img" to svgs.
- Add aria-label to svg elements with alt text if present. Screen readers ignore alt attributes on svg elements but do pay attention to aria-label (#9525).
- Text.Pandoc.Shared: Fix regression in section numbering in makeSections (#9516). Starting with pandoc 3.1.12, unnumbered sections incremented the section number.
- Text.Pandoc.Class: fix openUrl TLS negotiation (#9483). With the release of TLS 2.0.0, the TLS library started requiring Extended Main Secret for the TLS handshake. This caused problems connecting to zotero’s server and others that do not support TLS 1.3. This commit relaxes this requirement.
- Depend on djot 0.1.1.0 (fixes rendering on multiline block attributes).
- Use new releases of skylighting-format-blaze-html (#9520). Fixes auto-wrapping of long source lines in HTML print media.
- Use new commonmark-extensions (fixes issue with the rebase_relative_paths extension when used with commonmark/gfm.
- Makefile: improve epub-validation target (#9493). Use --epub-cover-image to catch issues that only arise with that.

- EPUB writer: omit EPUBv3-specific accessibility features on epub2 (#9469). Fixes a regression in 3.1.12.
- More fixes for SVG ids with --self-contained (#9467). This generalizes the fix to #9420 so it applies to things like style="fill(url(#..." and should fix problems with SVGs including gradients.
- Powerpoint writer: properly handle math in headings and tables (#9465). This ensures that paragraphs containing math are wrapped in a mc:AlternateContent node as required.
- Makefile: make validate-epub check v2 output too.

- Add djot as input and output format. Djot is a light markup syntax (https://djot.net).
- New module Text.Pandoc.Readers.Djot [API change]. The function readDjot is also exported by Text.Pandoc.Readers.
- New module Text.Pandoc.Writers.Djot [API change]. The function writeDjot is also exported by Text.Pandoc.Writers.

- --number-sections now uses the first digit for the number of the top-level section, no matter what its level. So if the top-level section is level-2, numbers will be 1, 2, etc. rather than 0.1, 0.2, as in the past (#5071). For some backwards compatibility, we revert to the old behavior when the --number-offset option is used.
- DocBook reader:
- Better handling of <procedure> and <substeps> (#9341): <procedure> now gets parsed as an ordered list, and <substeps> as a sublist.

- Man reader:
- Move spaces outside of emph/strong (#9445).

- MediaWiki reader:
- Don’t make leading blanks underscores in image links (#9425).
- Allow lowercase image: (#9424).

- BibTeX reader:
- Support pagetotal in converting BibLaTeX.

- Markdown reader:
- Fix wikilinks extensions to allow newlines in titles (#9454).

- EPUB reader:
- Don’t put # characters in identifiers.

- LaTeX reader:
- Improve treatment of \cref, \Cref (#7463). Use the reference-type ref+label and ref+Label. Also, associate with \vref ref instead of ref+page.
- Limited support for \Cref (#7463).
- Generate relative widths for \linewidth, \textheight (#9388).

- Typst reader:
- Fix handling of \overline (#9294). Due to a typo, it was being incorrectly rendered as an \underset.
- Improve handling of inline #quote (#9413).
- Fix handling of dot(), tilde(), ddot() (jgm/typst-hs#38).
- Fix character used for norm (jgm/typst-hs#38).

- Typst writer:
- Use reference form (e.g. @jones2000[p. 30]) for citations when possible.
- Use #ref or @ for links with reference-type="ref" (#7463). This attribute is added to LaTeX \cref, for example.
- Improve citation support (#9452). Emit form: "prose" or form: "year" qualifiers if the citation is author-in-text or suppress-author. Strip initial comma from suffix, since typst will add an extra one.
- Unescape URI escapes in image paths (#9389).
- Handle labels and citaiton ids with spaces and other special characters (#9387). In these cases, we produce an explicit label() rather than using <> or @.
- Avoid producing illegal labels (#9387).
- Avoid unnecessary escapes (#9386).

- LaTeX writer:
- Make writer sensitive to empty_paragraphs extension (#9443).
- Fix beamer highlighting (mh4ckt3mh4ckt1c4s).
- Create valid table even when table is empty (#9350).
- Set font fallback for babel main font (Max Heller).
- Add some kerns where needed between quotes (#9371).

- HTML writer:
- Add suffix to multiple footnote section ids, so they are unique (Sam May). This is necessary when --reference-location is block or section.

- EPUB writer:
- Add ARA roles for accessibility (#9378, Iacobus1983). Footnote references are given role “doc-noteref”, footnote text gets “doc-footnote”, and nav gets “doc-toc”.
- Ensure that an alt attribute is always added (#9354). This seems to be required by iBooks; even an empty alt attribute will satisfy it.
- Add xml:lang to package element (#9372).
- Add accessibility metadata to EPUB metadata (#9372, #9400, Iacobus1983 and John MacFarlane). Reasonable default values are used to ensure that pandoc’s EPUBs conform to the EU Accessibilty Act requirements, but values can be overridden using metadata.

- Docx writer:
- Restore ability to center-justify table (#9393). The fix to #5947 caused all tables to be left indented. This was necessary to avoid extra indentation in table cells when a table appeared in a list item. This change makes the changes conditional, so that they only affect tables in list items.

- Man writer:
- Fix bug with long URLs (#9458). URLs with more than 68 characters didn’t display properly because of wrapping.
- Support (limited) syntax highlighting in code blocks (#9446). Currently only b