# Pandoc 3.10 — pandoc 3.10

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

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 --typst-input CLI option to pass parameters to typst evaluator via sys.inputs
- **changed** — groff is now the default pdf-engine for ms format, replacing pdfroff
- **added** — auto_identifiers extension and related extensions are now available for the man reader
- **changed** — OpenDocument/ODT writer now uses predefined styles instead of emitting automatic styles for every paragraph
- **added** — Markdown reader now allows grid tables to be indented by up to three spaces
- **fixed** — Markdown reader: fix calculation of column widths for default columns in grid tables
- **fixed** — HTML reader: parse aside as a Div with class aside instead of using raw HTML
- **added** — HTML reader: add header class to Divs created from headers
- **fixed** — Docx reader: fix bug in bitmask checking that led to some table rows being wrongly considered header rows
- **fixed** — Docx reader: improve treatment of tblHeader element to not consider it a header if w:val is 0
- **changed** — Docx reader: with citations extension, prefer citation-key as the key for item data if defined
- **fixed** — Docx reader: don't look to ext tags for image extent
- **added** — Man reader: support auto_identifiers, gfm_auto_identifiers, and ascii_identifiers extensions for section headings
- **fixed** — Man reader: better handling of .TP macro to include all material until next indentation-changing macro
- **fixed** — Roff reader: handle backslash line continuation in table cells
- **fixed** — LaTeX reader: evaluate theorem name when used rather than when \newtheorem command is encountered
- **fixed** — LaTeX reader: put identifier from label on table attributes rather than adding an enclosing Div
- **fixed** — Typst reader: fix issue parsing figure inside rotate or box
- **fixed** — RTF reader: fix tables parsed as deeply nested tables
- **fixed** — Docx writer: fix display of paragraph with just inline math by adding zero-width space

```
I'm pleased to announce the release of pandoc 3.10,
available in the usual places:

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.10

Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.10

In addition to the usual basket of bug fixes and small improvements,
the following changes are worth mention:

- This release adds a --typst-input option, which allows passing
  arbitrary `sys.inputs` parameters to the typst evaluator.

- groff is now the default pdf-engine for the ms format, replacing
  pdfroff.

- The auto_identifiers extension (and related extensions) are
  now available for the man reader.

- OpenDocument/ODT now uses predefined styles instead of emitting
  automatic styles for every paragraph. This yields more idiomatic,
  and more easily stylable, output, resolving a handful of longstanding
  issues. If you use a custom reference.odt, it may need some updating.

API changes:

- Text.Pandoc.App.Opt: Opt has a new fieldi optTypstInputs.
- Text.Pandoc.Options: ReaderOptions has a new field readerTypstInputs.

Thanks to all who contributed, especially new contributors Dan Jacobson,
Johan Larsson, Keenan Brock, Meher Chaitanya, Sai Asish Y, and nibras shami.
```

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

- Add `--typst-input` CLI option (#11588). This allows one to pass parameters to typst, which are available at `sys.inputs`, just as `typst` itself does with its `--input` option.

- Avoid trailing spaces in `--help` output (#11623).

- Make groff the default pdf-engine for `ms` output (#11558). Formerly it was pdfroff.

- Set default User-Agent request header to `pandoc/VERSION`. This can be overridden using the `--request-header` option.

- Markdown reader:

  - Allow grid tables to be indented (#11671, Johan Larsson). Like the other table syntaxes (pipe, simple, and multiline tables) and block-level constructs generally, a grid table may now be indented by up to three spaces and still be recognized as a table. Previously the grid-table parser required the table to begin at the left margin, so an indented grid table was parsed as a paragraph.
  - Fix calculation of column widths for default columns in grid tables (#11664). This fixes a bug which produced too-narrow columns in some cases.
  - Don’t produce empty Raw element with `--strip-comments` (#11625).
  - Fix quotes in inline notes (#11613, Andrew Dunning).
  - Allow spaces inside attributes in super/sub (#11589).
  - Simplify `checkNotes`, remove dead code
  - Various small performance optimizations.

- HTML reader:

  - Parse aside as a Div with class “aside” (instead of using raw HTML) (#11626).
  - Add “header” class to Divs created from headers.

- Docx reader:

  - Fix bug in bitmask checking (#8299). This led to some table rows being wrongly considered header rows.
  - Improve treatment of `tblHeader` element (#8299). If `tblHeader` exists but has `w:val="0"`, then don’t consider the element a header.
  - With `citations` extension, prefer `citation-key` as the key for item data, if it is defined (#11581; cf. #10366, #11567). The `id` key used by Zotero is not exposed by their API and is generally not what is wanted when converting to biblatex.
  - Don’t look to `ext` tags for image extent (#11580). This reverts a change from 7ff1b798c4e6681ef9050899442d80883116573a. The change was mistaken and could cause images to be parsed with the wrong sizes.

- Man reader:

  - Support `auto_identifiers`, `gfm_auto_identifiers`, and `ascii_identifiers` extensions (#8852, Meher Chaitanya). Section headings parsed from .SH and .SS macros now receive auto-generated id attributes when the extension is enabled (as it is by default). This enables `--toc` to produce working anchor links.
  - Better handling of `.TP` macro (#11668). We parse these as DefinitionList items, but we previously sometimes stopped prematurely in including material

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