# Pandoc 3.10.1 — pandoc 3.10.1

- Product: Pandoc (https://whatsnew.fyi/product/pandoc)
- Vendor: John MacFarlane
- Date: 2026-07-22
- Version: 3.10.1
- Original notes: https://github.com/jgm/pandoc/releases/tag/3.10.1
- Permalink: https://whatsnew.fyi/product/pandoc/releases/3.10.1

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** — t2t (Txt2Tags markup) is now an output format
- **added** — New module Text.Pandoc.Writers.Txt2Tags, exporting writeTxt2Tags
- **added** — Support auto_identifiers extension with typst input
- **added** — New flake.nix allows use of 'nix build' and 'nix run' with pandoc
- **changed** — Defaults file no longer requires .yaml extension; pandoc will add it only if no file exists with the specified name
- **changed** — Use '#divider()' (typst 0.15) for typst horizontal rules instead of defining a custom horizontalRule function
- **changed** — Ordered sublists must start with 1 or equivalent (e.g. i)
- **changed** — Automatically enable auto_identifiers when a table of contents is requested
- **changed** — Use starmath instead of MathML for math in ODT, improving appearance and editability of equations
- **fixed** — RST reader: nested placeholder resolution for inline elements (regression from pandoc 3.6)
- **fixed** — RST reader: treat undefined substitution references as plain text
- **fixed** — ODT reader: don't create Emph just because of changed font
- **fixed** — RTF reader: support multi-paragraph list items
- **fixed** — RTF reader: support legacy \pn/\pntext paragraph numbering
- **fixed** — Docx reader: improve horizontal rule detection
- **fixed** — Docx reader: key list numbering off abstractNumId, fixing numbering for restarted lists
- **fixed** — LaTeX reader: handle \hypertarget with one braced parameter
- **fixed** — LaTeX writer: provide a way to use table instead of longtable via float class on tables
- **fixed** — Markdown writer: fix ordered list indentation bug

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

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

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

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