# Pandoc 3.8.3 — pandoc 3.8.3

- Product: Pandoc (https://whatsnew.fyi/product/pandoc)
- Vendor: John MacFarlane
- Date: 2025-12-01
- Version: 3.8.3
- Original notes: https://github.com/jgm/pandoc/releases/tag/3.8.3
- Permalink: https://whatsnew.fyi/product/pandoc/releases/3.8.3

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Add asciidoc as an input format
- **added** — Add xlsx (Microsoft Excel) as an input format, where each worksheet turns into a section containing a table
- **added** — Add pptx (PowerPoint) as an input format
- **added** — Add bbcode as an output format with variants: bbcode_fluxbb, bbcode_phpbb, bbcode_steam, bbcode_hubzilla, and bbcode_xenforo
- **added** — Export new module Text.Pandoc.Readers.AsciiDoc with readAsciiDoc function
- **added** — Export new module Text.Pandoc.Readers.Pptx with readPptx function
- **added** — Export new module Text.Pandoc.Readers.Xlsx with readXlsx function
- **added** — Export new module Text.Pandoc.Writers.BBCode with writeBBCode and variant functions
- **added** — Export insertCurrentSpansAtColumn, takePreviousSpansAtColumn, and decrementTrailingRowSpans from Text.Pandoc.Writers.Shared
- **added** — Export allRowsEmpty and tableBodiesToRows from Text.Pandoc.Shared
- **added** — Add reveal.js scroll and scrollSnap options to HTML writer and template
- **added** — Add Space elements in Djot reader to represent breakable spaces
- **fixed** — Revert \linebreak to LineBreak in LaTeX reader
- **fixed** — Fix spurious paragraph breaks in math environments in LaTeX reader
- **fixed** — Fix rawTeXParser to make macro expansion in raw LaTeX depend on the latex_macros extension setting
- **fixed** — Fix performance issue in Markdown reader with links containing apostrophes
- **fixed** — Handle REF link instruction in Docx reader
- **fixed** — Check recursively for caption styles in Docx reader to recognize caption styles built on top of basic caption style
- **fixed** — Fix Typst reader to handle document metadata and #title function
- **fixed** — Fix intraword emphasis handling in RST reader

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

<details>
  <summary>Click to expand changelog</summary>

- 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 return

_[Truncated at 4000 characters — full notes: https://github.com/jgm/pandoc/releases/tag/3.8.3]_