# Pandoc 3.11 — pandoc 3.11

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

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 `--math-method` option to replace the deprecated options `--mathml`, `--mathjax`, `--gladtex`, `--katex`, `--webtex`, with `plain` style now explicitly specifiable
- **changed** — Make `mathml` the default math-method
- **added** — Add `--completion={bash,zsh,fish}` option to generate completion scripts for all three shells
- **changed** — Make `--bash-completion` an alias of `--completion=bash`
- **added** — Add syntax `(1@label)` for resetting Markdown example list counter
- **added** — Support RTL text direction in ODT/OpenDocument writers
- **changed** — Setting `lang` at the document level in Docx is now sufficient to make documents RTL
- **added** — Handle `pre` without `code` in HTML reader and preserve whitespace as nonbreaking spaces
- **added** — Add support for nested tables in RTF reader
- **fixed** — Handle case where non-header rows come before header rows in Docx reader
- **fixed** — Improve handling of tables with uneven rows in Docx reader
- **fixed** — Fix illegal use of `p` element inside `p` in JATS writer
- **fixed** — Fix treatment of DefaultHighlighting in ODT/OpenDocument and Ms writers
- **fixed** — Fix bug in syntax highlighting in ConTeXt writer
- **fixed** — Fix pandoc 3.8 regressions in syntax highlighting
- **fixed** — Fix upgrade detection for per-machine installations in MSI installer
- **security** — Fix security-related bug in template fetching which could result in a local file being fetched instead of a remote one
- **changed** — Rename HTMLMathMethod type to MathMethod in Text.Pandoc.Options API
- **changed** — Rename `writerHTMLMathMethod` field to `writerMathMethod` in WriterOptions API
- **changed** — Rename `optHTMLMathMethod` constructor to `optMathMethod` in Text.Pandoc.App.Opt API

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

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

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

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