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.$$$$$$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

pandoc 3.7.0.1 Latest$$$This release fixes some serious problems with the new grid table writer introduced in 3.7. If you installed 3.7; I recommend you upgrade.$$$$$$It also fixes tagging with -t context+tagging.$$$$$$Text.Pandoc.Shared.Writer: Fix numerous problems with gridTable and add tests (#10848). These fixes affect the Markdown; RST; and Muse writers.$$$$$$Fix context writer/template to produce tagged PDFs (#10846). As before; the tagging extension must be enabled. We now add the command that tells ConTeXt to start tagging.

3.7$$$Im 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 cant 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.$$$$$$For more details refer - https://github.com/jgm/pandoc/releases/tag/3.7

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 $$$ewline; \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 wi

DocBook reader:$$$Handle title inside orderedlist. Also some other elements that allow title: blockquote; alloutlist; etc.$$$Better handle informal equation. 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 extensions for MediaBag items (#10557; Max Heller). This should give different results for remote images that are served at URLs that do not contain misleading extensions (e.g. shields.io).$$$Text.Pandoc.Citeproc:$$$Fix moving punctuation before citation notes. This previously worked with regular citations; but not author-in-text citations. Now it works with both.$$$doc/lua-filters.

pandoc 3.6.2 Latest$$$@jgm jgm released this last week$$$· 6 commits to main since this release$$$ 3.6.2$$$ fd49684$$$Click to expand changelog$$$New input 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).

pandoc 3.6.1 Latest$$$3.6.1$$$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 $$$ocite 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

pandoc 3.6$$$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).$$$$$$Refer for full details - https://github.com/jgm/pandoc/releases/tag/3.6

pandoc 3.5 Latest$$$@jgm jgm released this 2 days ago$$$· 3 commits to main since this release$$$ 3.5$$$ 31e4fab$$$Click to expand changelog$$$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 a26ec96 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 o

pandoc 3.4 Latest$$$@jgm jgm released this 11 hours ago$$$· 2 commits to main since this release$$$ 3.4$$$ 687155e$$$Click to expand changelog$$$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:

pandoc 3.3 (2024-07-28)±$$$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.

Click to expand changelog$$$Fix gfm_auto_identifiers to replace emojis with their aliases; as documented (#9876).$$$$$$CSV reader:$$$$$$Turn line breaks into LineBreaks not SoftBreaks (#9797).$$$Docx reader:$$$$$$Support task lists (#8211).$$$Fix a small bug in parsing delimiters in numbered lists; which led to the default delimiter being used wrongly in some cases.$$$Improve handling of captions.$$$Turn captioned images into Figure elements. Closes #9391.$$$Improve the logic for associating elements with captions (#9358).$$$Ensure that captions that can’t be associated with an element aren’t just silently dropped (#9610).$$$Support HorizontalRule. We support both pandoc-style and the style described on a Microsoft support page; an empty paragraph with a bottom border (#6285).$$$React to left value on jc attribute.$$$Handle column and cell alignments (#8551). We take the column alignments from the first body row.$$$Fix a bug that caused comments inside insertions or deletions to be ignored (#9833).$$$HTML reader:$$$$$$Better handle non-li elements in ul and ol (#9809). For example; a p after a closed li will be incorporated into the previous li. This mirrors what browsers do with this invalid HTML.$$$LaTeX reader:$$$$$$Fix parsing of dimensions beginning with .; e.g. \kern.1pt (#9902).$$$Markdown reader:$$$$$$Allow author-only textual citations (#7219). E.g. -@reese2002 outside of brackets.$$$RST reader:$$$$$$Tighten up rules for when emphasis can start (#9805).$$$Support :cite: role with citeproc (#9904). A subset of the functionality of the sphinxcontrib-bibtex extension to Sphinx is supported.$$$Textile reader:$$$$$$Don’t let spans begin right after a symbol (#9878).$$$Texinfo writer:$$$$$$Ensure proper escaping in all node/link contexts.$$$Target node rather than anchor when possible in internal links.$$$Remove illegal characters from internal link anchors (#6177).$$$Use two commas not one in @ref.$$$Don’t add anchors to headings. We don’t need them; now that we make internal links use the node.$$$Avoid duplicate node names.$$$Improve menus. Properly handle the case where the node name is different from the descriptive title.$$$Texinfo template: add variables for filename and version.$$$$$$Typst reader:$$$$$$Fix an incomplete pattern match (#9807).$$$$$$Handle inline bodies ending in a parbreak. E.g.$$$$$$`#strong[$$$test$$$]$$$ConTeXt template: remove \setupbackend[export=yes] (#9820).$$$$$$Docx writer:$$$$$$Omit jc attribute on table cells with AlignDefault (#5662).$$$Better formatting for task lists. Task lists are now properly formatted; with no bullet (#5198).$$$Replace an expensive generic traverse to remove Space elements; for better performance.$$$The new OpenXML template had spaces for metadata that need to be filled with OpenXML fragments with the proper shape. This patch ensures that everything is the right shape.$$$Wrap figures with id in a bookmark (#8662).$$$Add eastAsia font hints to w:r (#9817). We do this when the text in the run contains any CJK characters. This ensures that ambiguous code points (e.g. quotation marks) will be represented as “wide” characters when together with CJK characters.$$$Clean up Abstract Title and Subtitle in default reference docx. Center Subtitle; remove color.$$$Allow OpenXML templates to be used with docx (#8338; #9069; #7256; #2928). The --reference-doc option allows customization of styles in docx output; but it does not allow one to adjust the content of the output (e.g.; changing the order in which metadata; the table of contents; and the body of the document are displayed); or adding boilerplate text before or after the document body. For these changes; one can now use --template with an OpenXML template. (See the default openxml template for a sample.) --include-before-body and --include-after-body can also now be used with docx output. The included files must be OpenXML fragments suitable for inclusion in the document body.$$$New unexported module Text.Pandoc.Writers.Docx.OpenXML.

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 that w

pandoc 3.1.12.3 Latest$$$$$$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:$$$$$$Fix HYPERLINK with only switch and no argument (#9246).$$$Org reader:$$$$$$Parse caption and label for grid tables (#9279).$$$MediaWiki reader:$$$$$$Handle multiline math in list items (#9293).$$$OPML writer:$$$$$$Respect --wrap options & --columns in contents of notes (#9297).$$$ODT/OpenDocument writers:$$$$$$Properly handle highlighting styles (#9287). These styles were going into an office:styles element in content.xml; but this is invalid. Instead they must go in styles.xml. The variable highlighting-styles no longer has any effect on the default opendocument template; and highlighting styles are not included in opendocument output.$$$Markdown writer:$$$$$$Add table identifier at end of caption if present (#9279).$$$Text.Pandoc.PDF:$$$$$$Expand list of environment variables to display in verbose output (#9303).$$$Ensure that we find all the LaTeX warnings requiring a rerun (#9284). This should fix a regression from 3.1.9 that led to incorrect alignments in tables (and possibly other issues).$$$Docx writer:$$$$$$Ensure that pandoc’s output validates (Edwin Török; #9273; #9269; John MacFarlane; #9265; #9266; #9264).$$$Don’t emit empty table rows; which seem to cause problems for Word (#9224).$$$LaTeX writer:$$$$$$Omit superfluous page locator label when used with --natbib or --biblatex (#9275). These will treat a bare number as a page locator; and they will be able to localize it. Note that the recognition of the locator label is locale-sensitive; if lang is de; then S. 33 is a page reference; and p. 33 is not!$$$Text.Pandoc.Chunks: Fine tune makeChunks (#9281).$$$$$$Ensure that chunks not based on sections (those with the “preamble” class) get unique identifiers; by appending chunk number.$$$This will also ensure that they get unique path names when the path is generated from the identifier.$$$Default HTML5 template: remove html5shiv (and support for IE < 9).$$$$$$Makefile:$$$$$$Fix make quick-stack: j was expecting a number (Edwin Török).$$$Run built pandoc (instead of pandoc in path).$$$Add validate-epub target; using epubcheck to test the golden files.$$$Add validate-docx-golden-tests target.

Typst writer:$$$$$$Emit ; after typst code; unless followed by space (#9252). Otherwise there’s the potential that the typst code will swallow up a following character.$$$Text.Pandoc.Logging:$$$$$$Add MakePDFWarning constructor to LogMessage [API change].$$$Add MakePDFInfo constructor to LogMessage [API change].$$$Text.Pandoc.PDF:$$$$$$LaTeX warnings are passed on to the user as warnings.$$$Use report with MakePDFWarning and MakePDFInfo to relay verbose information and warnings; instead of writing directly to stderr.$$$Parse logs to determine whether additional runs needed; instead of running a fixed number of times (#9255). (The number of times that was appropriate given pandoc’s default templates didn’t always work for custom templates; and thus pandoc 3.1.10’s change in the number of runs led to some regressions in PDF production.)$$$Makefile: in make prelease; add checks that pandoc-cli and pandoc have the same version; that pandoc-cli depends on this exact version of pandoc; that there is an entry for this version in the changelog; and that the version numbers in the generated man pages are correct.$$$$$$Regenerate man pages with pandoc 3.1.10. This properly escapes hyphens and fixes version numbers in man pages for pandoc-server and pandoc-lua.$$$$$$Depend on texmath 0.12.8.6. This omits unneeded lrs in typst math output.$$$$$$Depend on typst 0.5. This allows the typst reader to support multiline strings; the version type; and the as keyword with import.

JATS reader:$$$$$$Ignore <processing-meta> element (#9057; Julia Diaz).$$$Fix conversion of date to ISO 8601 format (#8865).$$$LaTeX template:$$$$$$Add code allow \cite to break across lines (#9050).$$$Fix regression with CSL display=block (#7363). This restores the line break before the block.$$$Rewrite CSLReferences environment to avoid depending on enumitem; which plays badly with beamer. Instead we use a regular list environment. Thanks to @jpcirrus for the concept (#9053).$$$Restore the pre-3.1.7 format of the CSLReferences environment; which again has two parameters. The first determines whether a hanging indent is used (1 = yes; 0 = no); and the second is the entry line spacing (0 = none).$$$Add a strut to avoid inconsistencies in spacing (#9058).$$$Remove a break at the end of CSLRightInline to avoid inconsistencies in spacing. It shouldn’t be necessary because the paragraph should extend to the right margin (#9058).$$$LaTeX writer:$$$$$$Fix regression with figure labels (#9045). In 3.1.7; pandoc added two labels to LaTeX figure environments; one with a phantomsection.$$$Fix default citeproc entry-spacing. According to the CSL manual; the default entry spacing is 1. We were treating it as 0 (#9058).$$$HTML writer:$$$$$$Use the ID prefix in the ID for the footnotes section (#9044; Benjamin Esham).$$$Fix CSL entry-spacing default (#9058).$$$Text.Pandoc.Citeproc: always include an entry-spacing attribute in the Div if the bibliography element contains an entry-spacing attribute (previously we omitted it when it was 0) (#9058).$$$$$$Clean up pandoc’s own man pages by regenerating with pandoc 3.1.7.$$$$$$pandoc-lua-engine: bump lower bound for pandoc (#9046).$$$$$$Depend on texmath 0.12.8.2; fixing binom in typst writer (#9063).

Org reader: allow example lines to end immediately after the colon (Brian Leung).$$$$$$Docx reader:$$$$$$Omit “Table NN” from caption (#9002).$$$Avoid spurious block quotes in list items (#8836).$$$JATS reader: Fix display of block elements (#8889; Julia Diaz). A number of block elements; like disp-quote; list; and disp-formula; were always treated as inlines if appearing inside paragraphs; even if their usage granted a separate block.$$$$$$HTML reader: avoid duplicate id on header and div (#8991).$$$$$$Typst writer:$$$$$$Use ~ for nonbreaking space; and escape literal ~ (#9010).$$$Put the label in right place for Div; use #block (#8991). Previously we were putting the label at the beginning of the Div’s contents; but according to the documentation such a label gets attached to the preceding element. We now use an explicit #block and add the label at the end.

Fix new variant of the vulnerability in CVE-2023-35936. Guilhem Moulin noticed that the fix to CVE-2023-35936 was incomplete. An attacker could get around it by double-encoding the malicious extension to create or override arbitrary files.$$$$$$--embed-resources: Use inline SVG instead of data uris for SVG images in HTML5 (#8948). Note that SelfContained does not have access to the writer name; so we check for HTML5 by determining whether the document starts with <DOCTYPE! html>. This means that inline SVG won’t be used when generating document fragments.$$$$$$Fix regression on short boolean arguments (#8956). In 3.1.5 boolean arguments were allowed an optional argument (true|false). This created a regression for uses of fused short arguments; e.g. -somyfile.html; which was equivalent to -s -omyfile.html; but now raised an error because pandoc attempted to parse o as a boolean true or false. This change allows the fused short arguments to be used again. Note that -strue will be interpreted as -s with an argument true; not as -s -t -rue. It is best to use long option names with the optional boolean values; to avoid confusion.

Add a Lua REPL (Albert Krewinkel). This can be started with pandoc lua -i. It is also possible to instruct a filter to open the REPL at a certain point; for debugging (see pandoc.cli.repl).$$$$$$Support typst as a --pdf-engine.$$$$$$Add typst writer (#8713). New module Text.Pandoc.Writers.Typst; exporting writeTypst [API change].

Click to expand changelog$$$EPUB reader: Give additional information in error if the epub zip container can’t be unpacked.$$$$$$TSV reader: don’t gobble tabs as whitespace (#8661).$$$$$$Org reader: accept empty tables (#8659).$$$$$$LaTeX reader: fix multiplication syntax for tabular (#8658). We recognized *{6}{...} but not *6{...} or *6c.$$$$$$Docx reader: parse image alt texts in LibreOffice generated files. LibreOffice tags images slightly differently than Word; this change lets the parses take that difference into account when looking for an image description (alt text).$$$$$$DocBook reader:$$$$$$Fix <xref> references to tables in DocBook files (#8626; Pavol Otto).$$$Parse figure as a Figure element in the AST (#8668).$$$JATS reader: avoid generating duplicate figure captions (#8669).$$$$$$RST reader: align with spec in syntax for role names (#8653). In particular; we now allow colons in row names.$$$$$$Add note on converting from .doc format to FAQs (#8654).

Fix regression with --print-highlight-style option (#8586).$$$$$$Add new --chunk-template option (#8581); allowing more control over the filenames in chunked HTML output.$$$$$$Text.Pandoc.App: Add optChunkTemplate constructor to Opt [API change].$$$$$$Text.Pandoc.Options: add writerChunkTemplate constructor to WriterOptions [API change].$$$$$$Text.Pandoc.Chunks: add Data; Typeable; Generic; ToJSON; FromJSON instances for PathTemplate [API change].$$$$$$Text.Pandoc.Citeproc: Fix bug in metaValueToReference (#8611). This bug caused us to get some repeated content when converting MetaBlock to Inlines.$$$$$$Textile reader:$$$$$$Support footnote backlinks (#8585; Stephen Altamirano).$$$Don’t allow brackets in URLs (#8582).$$$ODT reader: fix blockquote indent detection (#3437; Daniel Kessler).$$$$$$LaTeX writer: include short figure/table caption if one is given (Albert Krewinkel). Short captions are used by LaTeX when generating the list of figures or list of tables. Adding a short caption will now overwrite the full caption in these lists.

pandoc 3.0.1$$$Click to expand changelog$$$Fix use of extensions with custom readers (#8571).$$$$$$Text.Pandoc.Writers.Shared: export setupTranslations [API change]. Use this in HTML and OpenDocument writers; to ensure that translations are set up properly even when we don’t go through convertWithOpts.$$$$$$LaTeX reader: fix regression in macro resolution for environments (#8573).$$$$$$Chunked HTML writer: Fix handling of images with absolute URLs (#8567).$$$$$$HTML writer:$$$$$$Don’t omit newlines in task lists.$$$Don’t disable checkboxes in task lists (#8562).$$$Ensure that automatically set variables pandoc-version; outputfile; title-prefix; epub-cover-image; curdir; dzslides-core can be overridden by --variable on the command line. Previously they would create lists in the template Context; which is not desirable.$$$$$$Fix man page copying in linux/make_artifacts.sh (#8566). Previously we were copying the pandoc-server.1 pandoc page to pandoc-lua.1.$$$$$$pandoc.cabal: remove pandoc.cabal; stack.cabal from extra-source-files (#8560). The problem is that if these are in extra-source-files; then they get put in the tarball; and then anyone trying to build the source from an unpacked tarball will run into the problem that cabal.project and stack.yaml refer to pandoc-server; pandoc-lua-engine; and pandoc-cli; which aren’t in the tarball.$$$$$$Require texmath 0.12.6 for better MathML output.$$$$$$Fix typo in Lua filter documentation (Carlos Scheidegger).$$$$$$Fix formatting of link in pandoc-server.md (James Scott-Brown).$$$$$$Minor changelog fixups.

Fix regression with data uris in 2.19.1 (#8239). In 2.19.1 we used the base64URL encoding rather than base64.$$$$$$pandoc-server: handle citeproc parameter as documented (#8235).$$$$$$Org reader: treat emacs-jupyter src blocks as code cells (#8236; Albert Krewinkel). This improves support for notebook-like org files that are intended to be used with emacs-jupyter package.$$$$$$HTML writer and templates: revert to using width property for column widths (Albert Krewinkel). The default flex and overflow-x properties of a column are set to auto. In combination; these changes allow to get good results when using columns with or without explicit widths.$$$$$$Org writer (Albert Krewinkel):$$$$$$Add support for jupyter nodebook cells (#6367).$$$Prefix code language of ipynb code blocks with jupyter-. This is the convention used by the emacs-jupyter package.$$$Keep code block attributes as header args. This allows to keep more information in the resulting src blocks; making it easier to roundtrip from or through Org. Org babel ignores unknown header arguments.$$$Add code block identifier as #+name to src blocks.$$$Fix some typos in the codebase (luz paz).$$$$$$Require hslua-module-path 1.0.3 (#8228; Albert Krewinkel).

Refer the link(click on expand changelog) in Additional Information URL for the release notes