pandoc/release-announcements.txt

==============================================================================
Subject: [ANN] Pandoc 0.3
From:    John MacFarlane
Date:    Jan 9, 2007, 11:05:53 AM
Link:    https://groups.google.com/g/pandoc-announce/c/URDc_fgujwE
==============================================================================

I'm pleased to announce a major new release of Pandoc, with many new
features and bug fixes.
Documentation, links to downloads, and demonstrations are available on
Pandoc's home page:
http://sophos.berkeley.edu/macfarlane/pandoc/index.html.

The biggest changes since Pandoc 0.2 are the new DocBook writer, the
new footnote syntax, and a "--strict" option that seeks to duplicate
the behavior of Markdown.pl as much as possible. Recai Oktaş has
completely redesigned the build system and the wrappers, which are much
more robust and portable than before.

Binary packages are available for Mac OS X and Windows, and new Debian
packages are on the way. The source code and package downloads are now
hosted at Google Code: http://code.google.com/p/pandoc.

For full details on the changes, see the Changelog:
http://sophos.berkeley.edu/macfarlane/pandoc/changelog.html.

John MacFarlane



==============================================================================
Subject: Re: pandoc 0.4 released
From:    John MacFarlane
Date:    Aug 16, 2007, 4:15:43 AM
Link:    https://groups.google.com/g/pandoc-announce/c/Oy7si5SsFnE
==============================================================================

I'm pleased to announce the release of pandoc 0.4, with a host of
improvements and new features. You can download the source tarball or a
binary package over at Google Code (http://code.google.com/p/pandoc/),
and you can find documentation and demonstrations on the website
(http://sophos.berkeley.edu/macfarlane/pandoc/). If you encounter
bugs, please file a bug report using the issue tracker
(http://code.google.com/p/pandoc/issues/list).

Here's a brief summary of the new features:

For users:
* New output formats: ConTeXt and groff man.
* Support for definition lists and tables.
* Support for superscript, subscript, and strikeout (thanks to Bradley
Kuhn for the strikeout patch).
* Support for automatically generated tables of contents.
* Automatically generated unique identifiers for HTML headers.
* Enhanced ordered lists (start number and list number style are now
significant).
* Markdown links now printed as inline links by default, unless
--reference-links is used.

For Haskell programmers:
* Added a Text.Pandoc module that exports the main functions and data
structures.
* Library documentation includes a sample program using the library.

Under the hood:
* Refactored to avoid reliance on GHC's Text.Regex, which is slow and
unicode-unaware.
* Removed Key and Note block elements and simplified parsers.
* Improved handling of character entities.
* HTML output is now generated using Text.XHtml.



==============================================================================
Subject: pandoc 0.41 - bug fix release
From:    John MacFarlane
Date:    Aug 19, 2007, 6:33:40 PM
Link:    https://groups.google.com/g/pandoc-announce/c/3cW9Zmf8LJQ
==============================================================================

I've just released pandoc 0.41, which fixes some bugs in the
treatment of ordered lists in (extended) markdown and in the
handling of raw HTML in the markdown and HTML readers. For
details, see the changelog.

Sources and binary packages are available at
http://pandoc.googlecode.com/

John



==============================================================================
Subject: pandoc 0.42 - bug fix release
From:    John MacFarlane
Date:    Aug 26, 2007, 7:34:19 PM
Link:    https://groups.google.com/g/pandoc-announce/c/l9E_C3MR8iA
==============================================================================

I've just released pandoc 0.42, another bug fix release:

+ Added a new rule for enhanced ordered lists: lists with capital letters
followed by periods must have two spaces after the list marker. This is
to avoid misinterpreting paragraphs that start with someone's initials
as list items. Thus,

B. Russell was an English philosopher

will be interpreted as a regular paragraph;

B. Russell was an English philosopher

as an ordered list item.

+ Fixed handling of LaTeX footnotes with verbatim text in them.

+ Apply UTF8 filter to all include files (-H, -C, -A, -B options), so unicode
characters in them work properly.

+ Improved strict markdown compatibility.

+ Fixed column widths in HTML tables.

+ OSX packages are no longer supported. There were too many issues with
the binary's dependence on dynamic libraries (GMP in particular). Instead,
a MacPorts Portfile has been provided. I will go back to offering packages
if I can figure out how to do so cleanly.

A source tarball and Windows binary are available at
http://pandoc.googlecode.com.



==============================================================================
Subject: pandoc in macports and debian unstable
From:    John MacFarlane
Date:    Aug 28, 2007, 4:46:31 PM
Link:    https://groups.google.com/g/pandoc-announce/c/xJUtJITJMMQ
==============================================================================

I'm pleased to announce that pandoc has been added to
the debian unstable repository (thanks to Recai Oktaş).
Debian unstable users may now install using:

apt-get update
apt-get install pandoc # for the program & scripts
apt-get install libghc6-pandoc-dev # for the libraries
apt-get install pandoc-doc # for library documentation

pandoc has also been added to the MacPorts repository. Just

sudo port sync # to get the latest ports
sudo port install pandoc

John



==============================================================================
Subject: pandoc 0.43 - bug fix release - huge performance improvements
From:    John MacFarlane
Date:    Sep 2, 2007, 6:41:22 PM
Link:    https://groups.google.com/g/pandoc-announce/c/ZAOfpqI8ES4
==============================================================================

I've just released pandoc 0.43. The source tarball and Windows
package are available at http://pandoc.googlecode.com/.
It may be a few days before the MacPorts port and debian
package databases have been updated.

The most notable improvements in this release are in performance.
Here are some benchmarks for parsing a 178K test file (the TextMate
manual) in 'strict' mode, on an Intel Core Duo 1.66GHz machine
with 1G RAM:

10.30s Markdown.pl v 1.0.1
15.47s Markdown.pl v 1.0.2b8
5.14s pandoc 0.42
0.91s pandoc 0.43

In addition:

+ LaTeX output is now prettyprinted (wrapped and indented).
+ Fixed bug in LaTeX reader with 4th-level nested lists.
+ Fixed bug in LaTeX parser (command names can't contain digits).
+ Improved --strict compatibility for reference-style links.
+ Fixed inline code parsing so it better accords with Markdown.pl:
` `` ` is now parsed as <code>``</code>.
+ Markdown writer escapes paragraphs that begin like list items.

John



==============================================================================
Subject: pandoc 0.44 - bug fix release
From:    John MacFarlane
Date:    Sep 4, 2007, 4:42:46 AM
Link:    https://groups.google.com/g/pandoc-announce/c/WjOTZjpwFuk
==============================================================================

I've just uploaded pandoc 0.44 to http://pandoc.googlecode.com.
This release fixes two bugs:

* When --toc was used, invalid XHTML was produced (anchors around
headers). Now the anchors are put inside the header tags.
Thanks to Abhishek Dasgupta for pointing this out.
* The build process, which used 'runhaskell', did not work on
platforms where GHC is not "built for interactive use." Fixed
by compiling Setup.hs at the beginning of the build process.
Closes Debian #440668.

Sorry about the release so soon after 0.43, but the build problem
was urgent for Debian.

John



==============================================================================
Subject: pandoc 0.45 released
From:    John MacFarlane
Date:    Dec 9, 2007, 10:18:02 PM
Link:    https://groups.google.com/g/pandoc-announce/c/m7_LPNsXaw0
==============================================================================

I'm pleased to announce the release of pandoc 0.45. The source
tarball and Windows binary package are now available at
http://code.google.com/p/pandoc/. The debian package should
be updated relatively soon; ports in Macports and FreeBSD may
take more time.

Some highlights:

* Many bug fixes and structural improvements. See
http://johnmacfarlane.net/pandoc/changelog.txt for full
details.

* Improved treatment of math. Math is now rendered using unicode by
default in HTML, RTF, and DocBook output. For more accurate
display of math in HTML, --gladtex, --mimetex, and --asciimathml
options are provided. For documentation, see
http://johnmacfarlane.net/pandoc/README.html#math. For
demonstrations, scroll to the bottom of
http://johnmacfarlane.net/pandoc/examples.html.

* Removed support for box-style block quotes in markdown.

* More idiomatic ConTeXt output, thanks in large part to
Idris Samawi Hamid.

* Text wrapping in ConTeXt and LaTeX output.

* Pandoc now correctly handles all standard line endings (CR, LF,
CRLF).

* New --no-wrap option that disables line wrapping and minimizes
whitespace in HTML output.

* Build process is now compatible with both GHC 6.8 and GHC 6.6. GHC
and GHC_PKG environment variables may be used to specify which
version of the compiler to use, when multiple versions are
installed. Note that compiling pandoc with GHC 6.8.1 gives a
considerable increase in performance over 6.6. The executables
are also smaller.

John



==============================================================================
Subject: pandoc 0.46 released
From:    John MacFarlane
Date:    Jan 8, 2008, 9:12:56 PM
Link:    https://groups.google.com/g/pandoc-announce/c/VTqRM4POIe0
==============================================================================

I'm pleased to announce the release of pandoc version 0.46.
Downloads are available at http://code.google.com/p/pandoc/downloads/.
The debian package and macports and FreeBSD ports should be updated
soon.

This is mainly a bug fix release. Thanks to all who submitted bug
reports. I won't catalog the bug fixes here; see
http://johnmacfarlane.net/pandoc/changelog.txt for full details.

This release includes two enhancements:

1. A new option --sanitize-html has been added (and a corresponding
parameter of ParserState, for those using pandoc as a library).
This sanitizes HTML in Markdown and HTML input, using a whitelist
method. It replaces possibly harmful HTML with HTML comments,
and removes possibly harmful HTML attributes.

2. The options -H, -A, and -B have been made cumulative. So if you
want to include several files, just use the option multiple times
on the command line.

John



==============================================================================
Subject: ANN: pandoc 1.0.0.1
From:    John MacFarlane
Date:    Sep 14, 2008, 3:34:52 AM
Link:    https://groups.google.com/g/pandoc-announce/c/oSSUgpxqL0M
==============================================================================

I'm pleased to announce the release of pandoc version 1.0.0.1.

Some highlights of this release:

+ New GNU Texinfo writer (contributed by Peter Wang)
+ New OpenDocument XML writer (contributed by Andrea Rossato)
+ New ODT (OpenOffice document) writer
+ New MediaWiki markup writer
+ New delimited code block syntax
+ Handy generic functions for querying and transforming documents without
lots of boilerplate (thanks to Andrea Rossato)
+ Cleaner build system: pandoc can now be built as a regular Cabal package
+ New dependencies: utf8-string and zip-archive
+ Code is -Wall clean
+ New Windows installer
+ Better support for math, including display math
+ Better HTML sanitizing for use in web applications
+ Many minor improvements and bug fixes (see changelog for details)

Pandoc can optionally be compiled with support for

+ syntax highlighting of delimited code blocks, using the
highlighting-kate library (over 50 languages are supported)
(specify -fhighlighting)
+ automatically generated citations and bibliography, using
Andrea Rossato's hs-citeproc library (specify -fciteproc)

I am particularly excited about Rossato's experimental citation support.
It's basically a BibTeX-like system that one can use in any of pandoc's
output formats. So you can have automatically generated citations in a
blog post, a wiki page, or even a man page! It's not yet complete, but
it's far enough along for those with an adventurous spirit to use.

I am very grateful to everyone who contributed bug reports and code,
and especially to Andrea Rossato and Peter Wang for their major
contributions.



==============================================================================
Subject: ANN: pandoc 1.1
From:    John MacFarlane
Date:    Nov 6, 2008, 10:34:24 PM
Link:    https://groups.google.com/g/pandoc-announce/c/a_MPfOBtGyU
==============================================================================

I'm pleased to announce the release of pandoc 1.1.

This is mostly a bug-fix release: thanks to all of you who submitted bug
reports.

The main new feature is a `--jsmath` option that allows you to use
pandoc with [jsMath]. jsMath is slower than LaTeXMathML, but it has the
major advantage of working on all modern browsers.

Some minor new features:

+ HTML tables now include "odd" and "even" classes on alterating
rows, so you can style them with colors.
+ The Windows installer has been modified so that it no longer
requires administrative privileges.

John

[jsMath]: http://www.math.union.edu/~dpvc/jsMath/



==============================================================================
Subject: pandoc 1.2 released
From:    John MacFarlane
Date:    Mar 1, 2009, 8:19:35 PM
Link:    https://groups.google.com/g/pandoc-announce/c/14psnOWO2F0
==============================================================================

I'm pleased to announce the release of pandoc version 1.2.

The most significant new feature is support for literate Haskell.
You can now use pandoc directly on literate Haskell source files
to produce syntax-highlighted HTML output:

pandoc -s MyProg.lhs > MyProg.html

Pandoc will interpret text sections as (extended) markdown. If
you prefer to write literate Haskell using reStructuredText
or LaTeX, pandoc supports that too:

pandoc -s --from rst+lhs MyProg.lhs > MyProg.html
pandoc -s --from latex+lhs MyProg.lhs > MyProg.html

You can even convert from one style to another:

pandoc -s --from markdown+lhs --to latex+lhs MyProg.hs

This release also adds an '--email-obfuscation' option, so
the user can select an email obfuscation method (or disable
obfuscation), and support for citations using the latest version
of Andrea Rossato's citeproc-hs.

In addition, many bugs have been fixed. Thanks to everyone
who took the time to file bug reports.

John



==============================================================================
Subject: ANN: pandoc 1.2.1
From:    John MacFarlane
Date:    Jul 19, 2009, 2:36:14 AM
Link:    https://groups.google.com/g/pandoc-announce/c/lEz2OxCkVkY
==============================================================================

I'm pleased to announce the release of pandoc version 1.2.1.

This is mostly a bug fix release; see the changelog for details.

Users may notice a significant speedup in reading markdown in
--smart mode; the abbreviations parser has been made much more
efficient.

Default HTML output now wraps sections in divs with unique
identifiers. This should aid manipulation using javascript and
other tools.

We have made some progress in replacing the old POSIX shell
script wrappers with more portable Haskell wrappers. If the
'wrappers' flag is enabled ('cabal install pandoc -fwrappers'),
pandoc will build Haskell versions of hsmarkdown and
markdown2pdf. (Thanks to Paulo Tanimoto for the latter.)

Thanks to everybody who took the time to file a bug report.

John



==============================================================================
Subject: ANN: pandoc 1.3
From:    John MacFarlane
Date:    Dec 11, 2009, 8:04:09 AM
Link:    https://groups.google.com/g/pandoc-announce/c/kHo-ByCx3xQ
==============================================================================

I'm pleased to announce the release of pandoc 1.3, now available
for download from pandoc's google code site or from HackageDB.

In addition to fixing many bugs, this version adds the following
features:

* New --id-prefix option to help prevent duplicate identifiers
when you're generating HTML fragments.
* New --indented-code-classes option, which specifies default
highlighting syntax for indented code blocks.
* --number-sections now affects HTML output.
* Improved syntax for markdown definition lists. (See README
for a full description.)
* Better looking simple tables.
* Markdown tables without headers are now possible. (See
README for details.)
* New hard line break syntax: backslash followed by newline.
* Improved performance of markdown reader by ~10% by eliminating
the need for a separate parsing pass for notes.
* Improved syntax highlighting for literate Haskell.
* Support for "..code-block" directive in RST reader.
* Windows binary now includes highlighting support.
* Many bug fixes and small improvements. See changelog for details.

Thanks to everyone who reported bugs, and especially to buttock, who
contributed the patch for the --indented-code-classes option, and Luke
Plant, who contributed the patch for rST "..code-block" directives.

John

John MacFarlane
unread,
Dec 11, 2009, 7:32:04 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com
> * Improved syntax for markdown definition lists. (See README
> for a full description.)

Let me say a bit more about this, since it is the one potentially breaking
change (and the reason we went from 1.2.x to 1.3):

I wanted to make the definition list syntax more compatible with that of
PHP Markdown Extra. It's still not 100% compatible, because pandoc doesn't
allow multiple terms in a definition. But all PHP Markdown Extra definition
lists that don't contain multiple terms in a single definition should
work in pandoc now.

Previously, pandoc's definition list items were pairs consisting of a term
and a definition. Now they are pairs consisting of a term and a list of
definitions (each of which can have multiple blocks).

So, the Block type has changed: instead of

DefinitionList [([Inline],[Block])]

we now have

DefinitionList [([Inline],[[Block]])]

Where previously you had to begin each block of a definition with a ':'
on the left margin, now you just indent multiple blocks, just as when
you have multiple blocks in an ordered list item. The ':' now signals
the beginning of a new definition, not a continuation block within
the same definition.

What this means is that definition lists may be interpreted somewhat
differently in 1.3. Example:

apple
: fruit

: computer

would previously have given you a term with a single two-block definition,

<dt>apple</dt>
<dd>
<p>fruit</p>
<p>computer</p>
</dd>

it will now give you a term with two one-block definitions:

<dt>apple</dt>
<dd><p>fruit</p></dd>
<dd><p>computer</p></dd>

I regret the slight break in backwards compatibility, but it seemed
acceptable, since it won't lead to a major difference in how the documents
look on screen or in print output formats. (In most output formats,
there will be no difference in how these are treated; in HTML they are
treated differently, but the difference won't be very apparent on screen
unless you're doing something special with CSS.)

Some other improvements to definition lists:

The marker ':' no longer needs to be flush with the left
margin, so you can do this:

apple
: fruit

You can use '~' as well as ':' (a suggestion of David Wheeler):

apple
~ fruit

You can leave a blank line after the term:

apple

~ fruit

second paragraph of definition

~ computer (second definition for same term)

John



==============================================================================
Subject: ANN: pandoc 1.5
From:    John MacFarlane
Date:    Mar 21, 2010, 12:12:47 AM
Link:    https://groups.google.com/g/pandoc-announce/c/6Rrm-ZwDqyI
==============================================================================

I'm pleased to announce the release of pandoc version 1.5.

As usual, a source tarball and Windows installer are available
at http://code.google.com/p/pandoc/downloads/list. You can
also use 'cabal install' to get the latest version from HackageDB:

cabal update
cabal install pandoc

Many small bugs have been fixed (thanks to everyone who took the
time to report them). Here are the larger changes:

* The source code repository has been moved from subversion to
git. The new repository is at http://github.com/jgm/pandoc.
The old repository at googlecode will no longer be updated,
so if you're tracking pandoc development, you'll want to

git clone git://github.com/jgm/pandoc.git

* Pandoc has a new --mathml option for rendering TeX math as
MathML. This is cleaner than using the LaTeXMathML.js script
to do the work client-side.

* Pandoc 1.4 introduced the ability to override system data
files with files in the ~/.pandoc directory. Pandoc 1.5
adds a --data-dir option, allowing users to specify a directory
other than ~/.pandoc.

* A new --base-header-level option allows you to promote headers.
For example, --base-header-level=2 makes level 1 headers into
level 2 headers, level 2 headers into level 3 headers, and so
on. This is useful when you're integrating many smaller documents
into one bigger one.

* There is a new 'plain' output format, for even plainer text than
markdown. Plain output has no inline formatting, no links, no
pictures, and nothing even vaguely markupish.

* Titles and outhors in title blocks can now span multiple lines,
as long as the continuation lines begin with a space character.
(Thanks to Justin Bogner.)

* Pandoc can now read web pages directly off the net; if you specify
a URL as argument, pandoc will fetch the content via HTTP. In addition,
pandoc's HTML parser, formerly extremely picky, has been made
more forgiving. Since pandoc can now handle most web pages directly,
the html2markdown script has been removed.

* The hsmarkdown wrapper has also been removed, as it seems unnecessary
to have a separate script to do what pandoc --strict can do. If you
are using hsmarkdown, you can just create a symlink to pandoc under
the name hsmarkdown; when invoked under this name, pandoc will behave
just like the old hsmarkdown did.

* An image in a paragraph by itself is now rendered as a figure
in most writers, with the alt text as caption.

* reStructuredText tables are now supported (both simple and grid),
thanks to Eric Kow. Colspans and rowspans are not yet supported.

* In mediawiki, links with relative URLs are now rendered as
wikilinks. And headers have been promoted: '= head =' is now
a level 1 header, not level 2. (If you need the old behavior,
you can use the new --base-header-level option.)

* You can now use "inverse bird tracks" in markdown literate Haskell.
Inverse bird tracks are used for Haskell example code that is
not part of the literate program.

* The -B and -A options now imply -s and no longer work in standalone
mode.

* Headerless tables are now rendered properly in all writers.
HTML and Docbook tables now use tbody, thead, and cols.

* In LaTeX, \chapter is now used instead of \section when the
documentclass is book, report, or memoir.



==============================================================================
Subject: ANN: pandoc 1.5.0.1
From:    John MacFarlane
Date:    Mar 22, 2010, 8:17:14 AM
Link:    https://groups.google.com/g/pandoc-announce/c/f9q0aLr7Ono
==============================================================================

I've just released pandoc 1.5.0.1, which fixes a bug in the new
mathml capabilities introduced in pandoc 1.5. The bug is fairly
serious -- it can cause pandoc to go into an infinite loop for
certain kinds of input, when used with the --mathml option.
So I recommend the upgrade to everyone.

John



==============================================================================
Subject: ANN: pandoc 1.5.1
From:    John MacFarlane
Date:    Mar 24, 2010, 1:17:48 AM
Link:    https://groups.google.com/g/pandoc-announce/c/NcE-YZZ_Vl8
==============================================================================

I've just released pandoc 1.5.1, available in the usual places.

This just fixes a few bugs and makes minor changes that were needed
for debian packaging.

* Fixed a bug in the OpenDocument writer that occasionally caused
duplicate attributes (hence, invalid xml that would choke OpenOffice).

* Improved treatment of unicode characters in URIs. Previously these
caused URIs to be rejected altogether when sanitizeHTML was selected,
and were improperly escaped in HTML output. Now they are accepted and
properly escaped in the Pandoc AST, and hence in all output formats.

* Revised Setup.hs so it doesn't assume that the build directory is
'dist'.



==============================================================================
Subject: ANN: pandoc 1.5.1.1
From:    John MacFarlane
Date:    Mar 29, 2010, 4:44:37 PM
Link:    https://groups.google.com/g/pandoc-announce/c/DySLM8SIfFY
==============================================================================

I've just released pandoc 1.5.1.1, a bug fix release.
This fixes a regression in automatic header identifiers,
pointed out by Xyne. Header identifiers should again work
as advertized in the README. In pandoc 1.5.1 they would
sometimes generate XHTML names with invalid characters.

John



==============================================================================
Subject: [ANN] pandoc 1.6
From:    John MacFarlane
Date:    Jul 24, 2010, 7:39:05 PM
Link:    https://groups.google.com/g/pandoc-announce/c/VcOzo7YZHcQ
==============================================================================

I'm pleased to announce the release of pandoc 1.6.

As usual, a source tarball and Windows installer are available
at <http://code.google.com/p/pandoc/downloads/list>. You can
also use 'cabal install' to get the latest version from HackageDB:

cabal update
cabal install pandoc

Thanks to everyone who contributed, either by filing bug reports or by
contributing patches. Here is a summary of the major changes in this
version:

+ New EPUB and HTML Slidy writers. (Issue #122)

- [EPUB] is a standard ebook format, used in Apple's iBooks for
the iPad and iPhone, Barnes and Noble's nook reader, the Sony
reader, and many other devices, and by online ebook readers like
[bookworm]. (Amazon's Kindle uses a different format, MobiPocket,
but EPUB books can easily be converted to Kindle format.) Now you
can write your book in markdown and produce an ebook with a single
command! I've put up a short [tutorial here].
- [Slidy], like S5, is a system for producing HTML+javascript slide shows.

+ All input is assumed to be UTF-8, no matter what the locale and ghc
version, and all output is UTF-8. This reverts to pre-1.5 behavior.
Also, a BOM, if present, is stripped from the input.

+ Markdown now supports grid tables, whose cells can contain
arbitrary block elements. (Issue #43)

+ Sequentially numbered example lists in markdown with `@` marker.

+ Markdown table captions can begin with a bare colon and no longer need
to include the English word "table." Also, a caption can now occur
either before or after the table. (Issue #227)

+ New command-line options:

- `--epub-stylesheet` allows you to specify a CSS file that will
be used to style your ebook.
- `--epub-metadata` allows you to specify metadata for the ebook.
- `--offline` causes the generated HTML slideshow to include all
needed scripts and stylesheets.
- `--webtex` causes TeX math to be converted to images using the
Google Charts API (unless a different URL is specified).
- `--section-divs` causes div tags to be added around each section
in an HTML document. (Issue #230, 239)

+ Default behavior of S5 writer in standalone mode has changed:
previously, it would include all needed scripts and stylesheets
in the generated HTML; now, only links are included unless
the `--offline` option is used.

+ Default behavior of HTML writer has changed. Between 1.2 and 1.5,
pandoc would enclose sections in div tags with identifiers on the
div tags, so that the sections can be manipulated in javascript.
This caused undesirable interactions with raw HTML div tags. So,
starting with 1.6, the default is to put the identifiers directly
on the header tags, and not to include the divs. The `--section-divs`
option selects the 1.2-1.5 behavior.

+ API changes:

- `HTMLMathMethod`: Added `WebTeX`, removed `MimeTeX`.
- `WriterOptions`: Added `writerUserDataDir`, `writerSourceDirectory`,
`writerEPUBMetadata` fields. Removed `writerIncludeBefore`,
`writerIncludeAfter`.
- Added `headerShift` to `Text.Pandoc.Shared`.
- Moved parsing code and `ParserState` from `Text.Pandoc.Shared`
to a new module, `Text.Pandoc.Parsing`.
- Added `stateHasChapters` to `ParserState`.
- Added `HTMLSlideVariant`.
- Made `KeyTable` a map instead of an association list.
- Added accessors for `Meta` fields (`docTitle`, `docAuthors`, `docDate`).
- `Pandoc`, `Meta`, `Inline`, and `Block` have been given `Ord` instances.
- Reference keys now have a type of their own (`Key`), with its
own `Ord` instance for case-insensitive comparison.
- Added `Text.Pandoc.Writers.EPUB`.
- Added `Text.Pandoc.UUID`.
- Removed `Text.Pandoc.ODT`, added `Text.Pandoc.Writers.ODT`.
Removed `saveOpenDocumentAsODT`, added `writeODT`.
- Added `Text.Pandoc.Writers.Native` and `writeNative`.
Removed `prettyPandoc`.
- Added `Text.Pandoc.UTF8` for portable UTF8 string IO.
- Removed `Text.Pandoc.Writers.S5` and the `writeS5` function.
Moved `s5Includes` to a new module, `Text.Pandoc.S5`.
To write S5, you now use `writeHtml` with `writerSlideVariant`
set to `S5Slides` or `SlidySlides`.

+ Template changes. If you use custom templates, please update them,
particularly if you use syntax highlighting with pandoc. The old HTML
templates hardcoded highlighting CSS that will no longer work with
the most recent version of highlighting-kate.

- HTML template: avoid empty meta tag if no date.
- HTML template: Use default highlighting CSS from highlighting-kate
instead of hard-coding the CSS into the template.
- HTML template: insert-before text goes before the title, and
immediately after the <body> tag, as documented. (Issue #241)
- Added slidy and s5 templates.
- Added amssymb to preamble of latex template. (github Issue 1)

+ Removed excess newlines at the end of output. Note: because output
will not contain an extra newline, you may need to make adjustments
if you are inserting pandoc's output into a template.

+ In S5 and slidy, horizontal rules now cause a new slide, so you
are no longer limited to one slide per section.

+ Improved handling of code in man writer. Inline code is now monospace,
not bold, and code blocks now use .nf (no fill) and .IP (indented para).

+ HTML reader parses `<tt>` as Code. (Issue #247)

+ html+lhs output now contains bird tracks, even when compiled without
highlighting support. (Issue #242)

+ Colons are now no longer allowed in autogenerated XML/HTML identifiers,
since they have a special meaning in XML.

+ Code improvements in ODT writer. Remote images are now replaced with
their alt text rather than a broken link.

+ LaTeX reader improvements:

- Made latex `\section`, `\chapter` parsers more forgiving of whitespace.
- Parse `\chapter{}` in latex.
- Changed `rawLaTeXInline` to accept `\section`, `\begin`, etc.
- Use new `rawLaTeXInline'` in LaTeX reader, and export `rawLaTeXInline`
for use in markdown reader.
- Fixes bug wherein `\section{foo}` was not recognized as raw TeX
in markdown document.

+ LaTeX writer: images are automatically shrunk if they would extend
beyond the page margin.

+ Plain, markdown, RST writers now use unicode for smart punctuation.

+ Man writer converts math to unicode when possible, as in other writers.

+ `markdown2pdf` can now recognize citeproc options.

+ Command-line arguments are converted to UTF-8. (Issue #234)

+ `Text.Pandoc.TeXMath` has been rewritten to use texmath's parser.
This allows it to handle a wider range of formulas. Also, if a formula
cannot be converted, it is left in raw TeX; formulas are no longer
partially converted.

+ Unicode curly quotes are left alone when parsing smart quotes. (Issue #143)

+ Cabal file changes:

- Removed parsec < 3 restriction.
- Added 'threaded' flag for architectures where GHC lacks a threaded
runtime.
- Use 'threaded' only for markdown2pdf; it is not needed for pandoc.
- Require highlighting-kate 0.2.7.

+ Use explicit imports from `Data.Generics`. Otherwise we have a
conflict with the 'empty' symbol, introduced in syb >= 0.2. (Issue #237)

+ New data files: slidy/slidy.min.js, slidy/slidy.min.css, epub.css.

[EPUB]: http://en.wikipedia.org/wiki/EPUB
[Slidy]: http://www.w3.org/Talks/Tools/Slidy
[bookworm]: http://bookworm.oreilly.com/
[tutorial here]: http://johnmacfarlane.net/pandoc/epub.html



==============================================================================
Subject: ANN: pandoc 1.8 - citations, textile, org, macros, & more
From:    John MacFarlane
Date:    Jan 31, 2011, 3:15:09 AM
Link:    https://groups.google.com/g/pandoc-announce/c/Xa8ElcFGSyw
==============================================================================

I'm very happy to announce the release of pandoc 1.8!

As usual, a source tarball and Windows installer are available
at <http://code.google.com/p/pandoc/downloads/list>. You can
also use 'cabal install' to get the latest version from HackageDB:

cabal update
cabal install pandoc

Changes and new features -- too many to list here -- are summarized at
<http://johnmacfarlane.net/pandoc/releases.html>.

Major contributors to this version were Andrea Rossato (citeproc integration),
Nathan Gass (support for natbib and biblatex, revised test suite), Paul Rivier
(textile reader), and Puneeth Chaganti (org-mode writer). Thanks also to
everyone else who submitted bug reports or patches.

John



==============================================================================
Subject: ANN: pandoc 1.8.0.3
From:    John MacFarlane
Date:    Feb 5, 2011, 8:07:43 PM
Link:    https://groups.google.com/g/pandoc-announce/c/BhqP6Pabyy0
==============================================================================

I've uploaded pandoc 1.8.0.3 to HackageDB.

This fixes a couple of bugs and adds one new feature:
normal-looking HTML output!

Old:

<ol style="list-style-type: decimal"
><li
>one</li
><li
>two</li
></ol
>

New:

<ol style="list-style-type: decimal">
<li>one</li>
<li>two</li>
</ol>

This should make it easier to read and edit HTML produced by pandoc.



==============================================================================
Subject: ANN: pandoc 1.8.1.1
From:    John MacFarlane
Date:    Feb 13, 2011, 6:13:22 PM
Link:    https://groups.google.com/g/pandoc-announce/c/cS_RtLgXjW4
==============================================================================

I've uploaded pandoc 1.8.1.1 to HackageDB. This is mostly a bug
fix release, but it does add a new `--ascii` option, to produce HTML
without UTF-8 characters.

Changes can be seen at:
http://johnmacfarlane.net/pandoc/releases.html

John



==============================================================================
Subject: ANN: pandoc 1.8.1.2
From:    John MacFarlane
Date:    Jul 17, 2011, 12:31:46 AM
Link:    https://groups.google.com/g/pandoc-announce/c/E9WgE6Y9TAw
==============================================================================

I'm pleased to announce the release of pandoc 1.8.1.2.
This is mostly just a bug-fix release, with no API changes.

For details, see http://johnmacfarlane.net/pandoc/releases.html

You can 'cabal install', or get the source and a windows installer
from http://code.google.com/p/pandoc/downloads/list.

Thanks to all who contributed bug reports, suggestions, and patches!

John



==============================================================================
Subject: ANN: pandoc 1.8.2
From:    John MacFarlane
Date:    Jul 31, 2011, 8:07:26 AM
Link:    https://groups.google.com/g/pandoc-announce/c/deZUWb0r_8Y
==============================================================================

I'm pleased to announce the release of pandoc 1.8.2. Thanks to
everyone who participated by reporting bugs, suggesting improvements,
or sending patches.

GoogleCode: http://code.google.com/p/pandoc/downloads/list
HackageDB: http://hackage.haskell.org/package/pandoc-1.8.2
Release notes: http://johnmacfarlane.net/pandoc/releases.html

This is mostly a polish and bug-fix release, but there are a few
changes to notice:

* There is now a binary installer for OSX, so Mac users no longer
need to install the Haskell Platform to use pandoc.

* The default template naming scheme has changed: latex.template is
now default.latex, and so on. If you shadow the default templates
with files in your user data directory (~/.pandoc/templates on
*nix), you'll need to rename them.

* The HTML and LaTeX templates have been changed. If you use
customized versions of these, you'll want to update them.
To make it easier to keep up with changes in the default templates
in the future, I've put the templates in their own repository,
https://github.com/jgm/pandoc-templates. You can clone this
and merge in changes.

* Standalone HTML files now display the author and date after the
title (in addition to including them in meta tags). They can
be suppressed, if desired, using CSS. It is also now possible to
style the table of contents and add a header.

* If you specify a template on the command line using the --template
option, and pandoc does not find the template, it will now search for
it in your user data directory (~/.pandoc/templates on *nix).
And if you leave off an extension, it will supply one based on the
writer. So, for example, 'pandoc -t latex --template=report' will
use templates/report.latex in the user data directory, if it doesn't
find report.latex in the working directory.

* The LaTeX template no longer uses the ucs package by default, as
it is no longer maintained and interacts badly with some other packages.
This means that fewer non-ascii characters are supported; instead
of using ucs, it is better to switch to xelatex or lualatex.

* The --xetex option to pandoc has been deprecated. Pandoc now defaults
to producing a latex file that can be compiled by pdflatex, lualatex,
or xelatex.

* markdown2pdf can now use pdflatex (the default), lualatex (--luatex option),
or xelatex (--xetex option).

* If your LaTeX template uses the 'csquotes' package, pandoc will
detect this and use '\enquote' instead of literal quotation marks,
giving better support for localized quotation styles.

* The URL argument of --mathjax is now optional. If it is not provided,
pandoc will link directly to the MathJax CDN (as is now recommended).

John MacFarlane
unread,
Jul 31, 2011, 6:02:01 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com
**Important note for those who track the development version of pandoc**

From now on, after doing 'git pull', you'll need to do
'git submodule update --init' to bring in changes to
the templates.

Or you can automate this by creating a file post-merge in
.git/hooks/post-merge, with the following contents:

#!/bin/sh
git submodule update --init

Make it executable ('chmod +x .git/hooks/post-merge') and the
submodule update will be done automatically whenever you do
'git pull'.

John

+++ John MacFarlane [Jul 30 11 23:07 ]:



> I'm pleased to announce the release of pandoc 1.8.2. Thanks to
> everyone who participated by reporting bugs, suggesting improvements,
> or sending patches.
>
> GoogleCode: http://code.google.com/p/pandoc/downloads/list
> HackageDB: http://hackage.haskell.org/package/pandoc-1.8.2
> Release notes: http://johnmacfarlane.net/pandoc/releases.html
>
> This is mostly a polish and bug-fix release, but there are a few
> changes to notice:
>
> * There is now a binary installer for OSX, so Mac users no longer
> need to install the Haskell Platform to use pandoc.
>
> * The default template naming scheme has changed: latex.template is
> now default.latex, and so on. If you shadow the default templates
> with files in your user data directory (~/.pandoc/templates on
> *nix), you'll need to rename them.
>
> * The HTML and LaTeX templates have been changed. If you use
> customized versions of these, you'll want to update them.
> To make it easier to keep up with changes in the default templates
> in the future, I've put the templates in their own repository,
> https://github.com/jgm/pandoc-templates. You can clone this
> and merge in changes.
>
> * Standalone HTML files now display the author and date after the
> title (in addition to including them in meta tags). They can
> be suppressed, if desired, using CSS. It is also now possible to
> style the table of contents and add a header.
>
> * If you specify a template on the command line using the --template
> option, and pandoc does not find the template, it will now search for
> it in your user data directory (~/.pandoc/templates on *nix).
> And if you leave off an extension, it will supply one based on the
> writer. So, for example, 'pandoc -t latex --template=report' will
> use templates/report.latex in the user data directory, if it doesn't
> find report.latex in the working directory.
>
> * The LaTeX template no longer uses the ucs package by default, as
> it is no longer maintained and interacts badly with some other packages.
> This means that fewer non-ascii characters are supported; instead
> of using ucs, it is better to switch to xelatex or lualatex.
>
> * The --xetex option to pandoc has been deprecated. Pandoc now defaults
> to producing a latex file that can be compiled by pdflatex, lualatex,
> or xelatex.
>
> * markdown2pdf can now use pdflatex (the default), lualatex (--luatex option),
> or xelatex (--xetex option).
>
> * If your LaTeX template uses the 'csquotes' package, pandoc will
> detect this and use '\enquote' instead of literal quotation marks,
> giving better support for localized quotation styles.
>
> * The URL argument of --mathjax is now optional. If it is not provided,
> pandoc will link directly to the MathJax CDN (as is now recommended).
>



==============================================================================
Subject: ANN: pandoc 1.9
From:    John MacFarlane
Date:    Feb 6, 2012, 9:33:44 AM
Link:    https://groups.google.com/g/pandoc-announce/c/hTonoMuiXyw
==============================================================================

I'm pleased to announce the release of pandoc 1.9!

Release notes: http://johnmacfarlane.net/pandoc/releases.html
Source: http://hackage.haskell.org/package/pandoc-1.9
Binary installers: http://code.google.com/p/pandoc/downloads/list

New features include writers for docx, beamer, dzslides, and asciidoc,
improved code highlighting support, more robust LaTeX parsing, better
citation support, more flexibility in creating EPUBs, support for math
in reST, more consistent treatment of dashes in --smart mode, and
support for making HTML documents "self-contained." markdown2pdf has
been removed, and PDF production via latex has been incorporated into
pandoc itself.

This is the first release in six months, so there are a lot of
changes, including some breaking API changes. Users are advised to
read the release notes.

Thanks to Andrea Rossato, B. Scott Michel, Antoine Latter,
Masayoshi Takahashi, Ralf Stephan for contributing patches, and
thanks to everyone who contributed bug reports on the github issue
tracker or suggestions on the pandoc-discuss mailing list.



==============================================================================
Subject: ANN: pandoc 1.9.1
From:    John MacFarlane
Date:    Feb 9, 2012, 8:02:17 PM
Link:    https://groups.google.com/g/pandoc-announce/c/KJCXJdsmmzk
==============================================================================

I've released pandoc 1.9.1 on HackageDB and at the Google download site:
http://hackage.haskell.org/package/pandoc-1.9.1
http://code.google.com/p/pandoc/downloads/list

No new features, just some bug fixes:
http://johnmacfarlane.net/pandoc/releases.html#pandoc-1.9.1-2011-02-09

John



==============================================================================
Subject: ANN: pandoc 1.9.1.2
From:    John MacFarlane
Date:    Mar 10, 2012, 4:19:00 AM
Link:    https://groups.google.com/g/pandoc-announce/c/qViukX1yxNA
==============================================================================

I'm pleased to announce the release of pandoc 1.9.1.2, available
on hackage and at the googlecode download site,
http://code.google.com/p/pandoc/downloads/list

This is a bug-fix release. For a list of changes, see
http://johnmacfarlane.net/pandoc/releases.html



==============================================================================
Subject: ANN: pandoc 1.9.2
From:    John MacFarlane
Date:    Apr 5, 2012, 10:17:30 PM
Link:    https://groups.google.com/g/pandoc-announce/c/J7kjHJzJon0
==============================================================================

I've just released pandoc 1.9.2 on HackageDB and at the google code
download site (http://code.google.com/p/pandoc/downloads).

This is a bug fix release. For full release notes, see
http://johnmacfarlane.net/pandoc/releases.html.

Thanks to everyone who contributed patches, suggestions,
and bug reports.



==============================================================================
Subject: ANN: pandoc 1.9.3
From:    John MacFarlane
Date:    May 13, 2012, 5:14:34 AM
Link:    https://groups.google.com/g/pandoc-announce/c/6moqwKhKL50
==============================================================================

I'm pleased to announce the release of pandoc 1.9.3.

This is mostly a bug fix release, but I couldn't resist adding a DocBook
reader.

Release notes: http://johnmacfarlane.net/pandoc/releases.html
Downloads: http://code.google.com/p/pandoc/downloads/list
HackageDB: http://hackage.haskell.org/package/pandoc-1.9.3



==============================================================================
Subject: ANN: pandoc 1.9.4
From:    John MacFarlane
Date:    Jun 3, 2012, 9:06:22 PM
Link:    https://groups.google.com/g/pandoc-announce/c/ByZQ7UyLL1o
==============================================================================

I've just uploaded pandoc 1.9.4:
http://hackage.haskell.org/package/pandoc
http://code.google.com/p/pandoc/downloads/list

Release notes are here:
http://johnmacfarlane.net/pandoc/releases.html

This is mostly a bug-fix release. It fixes a major bug with citations
in footnotes, and a number of minor bugs. It also adds a Slideous
writer (thanks to Jonas Smedegaard). Slideous is an HTML slide format,
like Slidy, but it works better in IE 7.

There are some larger changes in the works, but I want to get a
relatively bug-free version of 1.9.* before moving on to 1.10.*.

John MacFarlane
unread,
Jun 3, 2012, 10:17:09 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com
Note: the windows installer contained a slightly older version
of the pandoc executable. I have fixed the problem, but if you
were one of the three people who downloaded the installer before
I fixed it, you may want to reinstall.

+++ John MacFarlane [Jun 03 12 12:06 ]:


> I've just uploaded pandoc 1.9.4:
> http://hackage.haskell.org/package/pandoc
> http://code.google.com/p/pandoc/downloads/list
>
> Release notes are here:
> http://johnmacfarlane.net/pandoc/releases.html
>
> This is mostly a bug-fix release. It fixes a major bug with citations
> in footnotes, and a number of minor bugs. It also adds a Slideous
> writer (thanks to Jonas Smedegaard). Slideous is an HTML slide format,
> like Slidy, but it works better in IE 7.
>
> There are some larger changes in the works, but I want to get a
> relatively bug-free version of 1.9.* before moving on to 1.10.*.
>

> --
> You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
> To post to this group, send email to pandoc-...@googlegroups.com.
> To unsubscribe from this group, send email to pandoc-discus...@googlegroups.com.
> For more options, visit this group at http://groups.google.com/group/pandoc-discuss?hl=en.
>



==============================================================================
Subject: ANN: pandoc 1.9.4.1
From:    John MacFarlane
Date:    Jun 8, 2012, 11:01:49 PM
Link:    https://groups.google.com/g/pandoc-announce/c/97t4vg-EWk4
==============================================================================

I've just released pandoc 1.9.4.1, which is now available
at the usual places:
http://code.google.com/p/pandoc/downloads/list
http://hackage.haskell.org/package/pandoc

This version works around a bug in citeproc-hs which caused
footnotes beginning with a citation to be empty. It also makes
a few other minor improvements, described here:
http://johnmacfarlane.net/pandoc/releases.html

John



==============================================================================
Subject: ANN: pandoc 1.9.4.2
From:    John MacFarlane
Date:    Jun 29, 2012, 5:55:31 PM
Link:    https://groups.google.com/g/pandoc-announce/c/UiIRqnCe4yU
==============================================================================

I'm pleased to announce the release of pandoc 1.9.4.2.
Binary packages and the source code are available at

http://code.google.com/p/pandoc/downloads

and as usual, pandoc can be installed using cabal:

http://hackage.haskell.org/package/pandoc-1.9.4.2

This is another bug fix release. Recent versions of GHC changed the way
GHC's base libraries encode file paths and command line arguments. As a
result, versions of pandoc compiled with these versions of GHC did not
work properly with non-ASCII filenames. This release fixes the bug;
pandoc should now work properly with non-ASCII filenames, no matter
what version of GHC it was compiled with.

This release also fixes a packaging bug in the OS X package installer,
which caused pandoc to hang when run with the --bibliography option.

The other notable change is that pandoc is now compiled with -rtsopts by
default. This means that you can change the default stack size, tune
garbage collection, and get information about memory usage by adding
special options after '+RTS' on the command line (see
http://www.haskell.org/ghc/docs/7.4.2/html/users_guide/runtime-control.html).
This is not something most users will need to do. Users should be aware,
however, that this new feature can be a security risk for some special
uses of pandoc. If you are running pandoc with setuid root, or if you
are running it from a web application with command-line options you
take from untrusted users (which is not a good idea anyway), you
would be well advised to compile pandoc without -rtsopts. (See
http://hackage.haskell.org/trac/ghc/ticket/3910.)

A few other minor improvements are described in the release notes:
http://johnmacfarlane.net/pandoc/releases.html



==============================================================================
Subject: Re: ANN: pandoc 1.10.0.4
From:    John MacFarlane
Date:    Jan 21, 2013, 7:42:59 AM
Link:    https://groups.google.com/g/pandoc-announce/c/UU9Kfg1DyBA
==============================================================================

I've released an update, 1.10.0.4, which fixes a rather serious
bug in the LaTeX reader affected escaped % characters.

+++ John MacFarlane [Jan 19 13 19:30 ]:
> I'm pleased to announce the release of pandoc 1.10, which is now
> available in the usual places:
>
> Hackage: http://hackage.haskell.org/package/pandoc
> Google Code: http://code.google.com/p/pandoc/downloads/list
>
> If you use cabal to install pandoc, I recommend upgrading to the
> latest versions of texmath, hs-bibutils, citeproc-hs, and highlighting-kate
> before reinstalling pandoc.
>
> Full release notes are here: http://johnmacfarlane.net/pandoc/releases.html
> This release includes many changes, so please look over the release
> notes, especially if you use pandoc as a library, use the --strict
> option, or rely on <q> tags for quotes in HTML5.
>
> Those who use custom templates should pay special attention to
> the template changes. (For example, longtable is now used instead
> of ctable, and LaTeX templates will need to be revised to reflect
> that.)
>
> This release adds a reader for MediaWiki markup and writers for
> FictionBook2 and EPUB v3 ebooks. (Thanks to Sergey Astanin for
> the FictionBook2 writer.)
>
> Markdown extensions can now be enabled or disabled individually. In
> addition, some extensions have been defined that are not in the default
> pandoc set (for example, an extension for github style line breaks and
> an extension for multimarkdown style metadata headers). As a result,
> pandoc can now be used to convert from one markdown dialect to another.
> Aliases have been defined for certain common packages of extensions:
> markdown_strict, markdown_phpextra, markdown_github, markdown_mmd.
> Note that one should not expect these intra-markdown conversions to be
> perfect: there are differences in markdown parsers besides just the
> extensions, and pandoc’s internal document model is not rich enough to
> capture all of the extensions in other markdown dialects.
>
> Pandoc's own markdown dialect has been extended thus:
>
> * Pipe tables can now be used.
> * Line blocks can be used for poetry and addresses.
> * Header identifiers can be given explicitly, as in "# My header {#foo}".
> * References links are automatically defined for headers, so you can say
> "See the [Introduction]" rather than
> "See the [Introduction](#introduction)".
>
> In addition to the new features, there are hundreds of bug fixes,
> small enhancements, and under-the-hood improvements. Thanks are due to
> everyone who submitted patches, made suggestions for improvements on the
> mailing list, submitted bug reports, or helped test the development
> version.
>
> John
>

John MacFarlane
unread,
Jan 20, 2013, 4:30:20 AM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com

I'm pleased to announce the release of pandoc 1.10, which is now
available in the usual places:

Hackage: http://hackage.haskell.org/package/pandoc
Google Code: http://code.google.com/p/pandoc/downloads/list

If you use cabal to install pandoc, I recommend upgrading to the
latest versions of texmath, hs-bibutils, citeproc-hs, and highlighting-kate
before reinstalling pandoc.

Full release notes are here: http://johnmacfarlane.net/pandoc/releases.html
This release includes many changes, so please look over the release
notes, especially if you use pandoc as a library, use the --strict
option, or rely on <q> tags for quotes in HTML5.

Those who use custom templates should pay special attention to
the template changes. (For example, longtable is now used instead
of ctable, and LaTeX templates will need to be revised to reflect
that.)

This release adds a reader for MediaWiki markup and writers for
FictionBook2 and EPUB v3 ebooks. (Thanks to Sergey Astanin for
the FictionBook2 writer.)

Markdown extensions can now be enabled or disabled individually. In
addition, some extensions have been defined that are not in the default
pandoc set (for example, an extension for github style line breaks and
an extension for multimarkdown style metadata headers). As a result,
pandoc can now be used to convert from one markdown dialect to another.
Aliases have been defined for certain common packages of extensions:
markdown_strict, markdown_phpextra, markdown_github, markdown_mmd.
Note that one should not expect these intra-markdown conversions to be
perfect: there are differences in markdown parsers besides just the
extensions, and pandoc’s internal document model is not rich enough to
capture all of the extensions in other markdown dialects.

Pandoc's own markdown dialect has been extended thus:

* Pipe tables can now be used.
* Line blocks can be used for poetry and addresses.
* Header identifiers can be given explicitly, as in "# My header {#foo}".
* References links are automatically defined for headers, so you can say
"See the [Introduction]" rather than
"See the [Introduction](#introduction)".

In addition to the new features, there are hundreds of bug fixes,
small enhancements, and under-the-hood improvements. Thanks are due to
everyone who submitted patches, made suggestions for improvements on the
mailing list, submitted bug reports, or helped test the development
version.

John

John MacFarlane
unread,
Jan 24, 2013, 5:41:37 AM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com
pandoc 1.10.0.5 is now released. I've solved the build
problem on Windows and fixed some serious bugs. Everyone should
upgrade.



==============================================================================
Subject: ANN: pandoc 1.10.1
From:    John MacFarlane
Date:    Jan 29, 2013, 1:25:18 AM
Link:    https://groups.google.com/g/pandoc-announce/c/UPgswsZ0I14
==============================================================================

I just released pandoc 1.10.1 in the usual places.

http://code.google.com/p/pandoc/downloads/list
http://hackage.haskell.org/package/pandoc

This is mostly just a bug fix release, but it also includes some
nice performance optimizations to the markdown parser. It also
relaxes the version bound on old-time, so that those with older
versions of GHC can again install pandoc. Release notes:

http://johnmacfarlane.net/pandoc/releases.html



==============================================================================
Subject: ANN: pandoc 1.11
From:    John MacFarlane
Date:    Mar 9, 2013, 6:45:58 AM
Link:    https://groups.google.com/g/pandoc-announce/c/5DjeQCJCev4
==============================================================================

I'm pleased to announce the release of pandoc 1.11.

Release notes: http://johnmacfarlane.net/pandoc/releases.html
Hackage (source): http://hackage.haskell.org/package/pandoc
OSX/Windows installers: https://code.google.com/p/pandoc/downloads

API changes:

* Text.Pandoc.Parsing and Text.Pandoc.Highlighting are no longer exposed.
* In Text.Pandoc.Shared, the Element type has changed. Sec now includes
a field for Attr rather than just String.
* ReaderOptions now includes a field readerDefaultImageExtension.
* WriterOptions now includes a field writerNumberOffset.

Behavior changes:

* New --number-offset option.
* New --default-image-extension option.
* Headers with class "unnumbered" are rendered as unnumbered sections
even if --number-sections is used.
* markdown_github can be used as an input format.
* Grid tables are now used when needed in markdown output.
* In markdown output, citations are rendered by default as pandoc markdown
citations (e.g. "[@smith99]"). If citeproc-rendered citations are
desired (the old default), use "pandoc -t markdown-citations".
* An HTML table of contents is included in epub (even epub2).
Use the --toc option if you want it to display at the beginning of
the book.

Bug fixes:

* Better treatment of display math in docx.
* Fixed section numbering in epub.
* BOM is stripped off of UTF8 input.
* And many more (see release notes).

Packaging improvements:

* The Windows and OSX installers are now signed with a certificate.
* The Windows installer is now a standard msi (produced by WiX).
* A bug has been fixed that prevented the OSX package from being
installed on some systems.

Thanks to everyone who contributed, by filing bug reports, submitted
patches, or making suggestions. Special thanks to Fyodor Sheremetyev,
who sponsored the code signing certificates.



==============================================================================
Subject: ANN: pandoc 1.11.1
From:    John MacFarlane
Date:    Mar 17, 2013, 11:42:09 PM
Link:    https://groups.google.com/g/pandoc-announce/c/2FnclifIEVs
==============================================================================

I'm pleased to announce the release of pandoc 1.11.1.

* Release notes: http://johnmacfarlane.net/pandoc/releases.html
* Hackage: http://hackage.haskell.org/package/pandoc
* https://code.google.com/p/pandoc/downloads/list

This release fixes a couple of serious regressions in pandoc 1.11.

There are two behavior changes worthy of note:

1. Unmatched double quotes in dialogue will now be converted
into curly left quotes when `--smart` is used. This should help with
multi-paragraph quotations in dialogue, where conventionally each
paragraph gets an open quote, but only the final paragraph gets a close
quote.

2. I have reverted a 1.11 change to the way citations are rendered by
the markdown writers. In 1.11, citations were rendered as pandoc
markdown citations (rather than as formatted citations) unless the
`citations` extension was disabled. That had some undesirable
consequences. Now, citations are always rendered as formatted
citations when the `--bibliography` option is used. If you want to
preserve pandoc markdown citations when converting from markdown to
markdown, just don't use the `--bibliography` option.

Thanks are due to Fyodor Sheremetyev for further improvements to the
Windows installer.

John



==============================================================================
Subject: ANN: pandoc 1.12
From:    John MacFarlane
Date:    Sep 15, 2013, 10:05:50 PM
Link:    https://groups.google.com/g/pandoc-announce/c/5QU1it4p5A0
==============================================================================

I'm pleased to announce the release of pandoc 1.12!

* Release notes: <http://johnmacfarlane.net/pandoc/releases.html>
* Hackage: <http://hackage.haskell.org/package/pandoc>
* Binary packages: <https://code.google.com/p/pandoc/downloads/list>
or <https://github.com/jgm/pandoc/releases/tag/1.12>

The focus of this release is customizability. Several features
have been added that should make it easier to fit pandoc to your
needs:

* Flexible metadata: metadata is no longer limited to title,
authors, and date. You can add whatever fields you like. Metadata
values are also structured: they can be lists, maps, booleans,
strings, or lists of pandoc Inline or Block elements. A new
YAML metadata block is provided so structured metadata can be
included in pandoc markdown documents. (Of course, the old title
blocks will still work, and can be combined with the YAML blocks.)
Template variables will automatically be set from metadata, so
if you want to create a template with variables like `subject`,
`abstract`, or `author.institution`, you can.

* A new `--filter` option is provided, to make it easier to use
JSON filters that transform the pandoc AST. Instead of

pandoc -t json -s | ./myfilter | pandoc -f json -t html5 -s

you can now do

pandoc -t html5 -s --filter ./myfilter

Pandoc passes the output format as the first argument to the
filter, so filters can easily be made sensitive to the output
format. (For example, a graphviz filter might produce a PNG
if the output is HTML and a PDF if the output is LaTeX.)

* For those who don't know Haskell, a python library,
`pandocfilters`, has been created to make it easy to write pandoc
filters using python. There are some examples in the
[pandocfilters repository](http://github.com/jgm/pandocfilters).

* You can now script your own custom pandoc writer using lua. See
example 33 on the
[demos page](http://johnmacfarlane.net/pandoc/demos.html). While
JSON filters are a better approach for most customizations, this
approach gives you complete control over the writer's behavior,
and allows you to support completely new output formats.

* Generic Inline (`Span`) and Block (`Div`) containers that take
attributes have been added to the underlying Pandoc types.
These provide the customization possibilites for formatted
text that the `Code` and `CodeBlock` elements provide for unformatted
text.

Other significant changes include support for OPML (as both an input
and an output format), support for writing reveal.js slide shows,
and support for reading Haddock markup.

Citation support has been extracted from core pandoc and put into
a new `pandoc-citations` package. (Users who install pandoc using
cabal should `cabal install pandoc-citations` if they want to use
citations.) Bibliographic information can now be included right in
a pandoc markdown document, inside a YAML metadata block, making
the document self-contained. (A tool `biblio2yaml` is provided to
convert existing bibliographies, for those who want to do this.)

Thanks to everyone who reported a bug, made a suggestion on
pandoc-discuss, or submitted a patch. This version includes patches
from Jamie F. Olson, Oliver Matthews, Max Rydahl Andersen,
Alexander Kondratskiy, David Lazar, Dirk Ullrich, Luis Osa,
Bernhard Weichel, Hiromi Ishii, Florian Eitel, Scott Morrison,
achalddave and drothlis. I hope I haven't left anyone out.

John MacFarlane
unread,
Sep 16, 2013, 5:12:27 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com
+++ Matthias Hüning [Sep 16 13 01:28 ]:

> > Citation support has been extracted from core pandoc and put into
> > a new `pandoc-citations` package. (Users who install pandoc using
> > cabal should `cabal install pandoc-citations` if they want to use
> > citations.)

This was a typo. It should be:

cabal install pandoc-citeproc

John

John MacFarlane
unread,
Sep 16, 2013, 5:18:07 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com
+++ John MacFarlane [Sep 16 13 08:12 ]:


> +++ Matthias Hüning [Sep 16 13 01:28 ]:
> > > Citation support has been extracted from core pandoc and put into
> > > a new `pandoc-citations` package. (Users who install pandoc using
> > > cabal should `cabal install pandoc-citations` if they want to use
> > > citations.)
>
> This was a typo. It should be:
>
> cabal install pandoc-citeproc

And, to be clear: pandoc-citeproc is included in the binary packages,
so if you use the OSX or Windows package installer to install 1.12,
you don't need this 'cabal install' step. It's only necessary for those
who are installing pandoc from source using the cabal tool.



==============================================================================
Subject: ANN: pandoc 1.12.0.1
From:    John MacFarlane
Date:    Sep 21, 2013, 3:34:48 AM
Link:    https://groups.google.com/g/pandoc-announce/c/ExgkvBCm7rE
==============================================================================

I'm pleased to announce pandoc 1.12.0.1. This just fixes a few
regressions in 1.12.

* Allow `--metadata` to be repeated for the same key to form a list.
This also has the effect that `--bibliography` can be repeated,
as before.

* Handle boolean values in `--metadata`. Note that anything not parseable
as a YAML boolean or string is treated as a literal string.
You can get a string value with "yes", or any of the strings interpretable
as booleans, by quoting it:

-M boolvalue=yes -M stringvalue='"yes"'

* LaTeX writer: Don't print references if `--natbib` or `--biblatex`
option used.

* DOCX writer: Add `settings.xml` to the zip container. Fixes a bug
in which docx files could not be read by some versions of Word
and LibreOffice (#990).

* Fixed a regression involving slide shows with bibliographies.
The Div container around references messed up the procedure for carving
a document into slides. So we now remove the surrounding Div in
`prepSlides`.

* More informative error message when a filter is not found in path.

* Depend on pandoc-types 1.12.1. This provide `ToJSONFilter`
instances for `Data a => a -> [a]` and `Data a => a -> IO [a]`.

* Don't use unicode_collation in building OSX package:
it adds something like 50MB of dependencies to the package.

* Declare alex and happy as build-tools (#986).

Binaries are availabel at
https://github.com/jgm/pandoc/releases/tag/1.12.0.1
https://code.google.com/p/pandoc/downloads/list

Pandoc can also be 'cabal installed'. I recommend that you update
pandoc-types and pandoc-citeproc at the same time:

cabal update
cabal install --reinstall pandoc-types pandoc pandoc-citeproc



==============================================================================
Subject: ANN: pandoc 1.12.0.2
From:    John MacFarlane
Date:    Sep 21, 2013, 5:34:52 AM
Link:    https://groups.google.com/g/pandoc-announce/c/SBYfoAK8ihY
==============================================================================

Pandoc 1.12.0.2 has been released to Hackage.

There is no binary package, because the only change is the removal
of an unused dependency from the cabal file.



==============================================================================
Subject: ANN: pandoc 1.12.1, pandoc-citeproc 0.1.2.1
From:    John MacFarlane
Date:    Oct 21, 2013, 1:09:34 AM
Link:    https://groups.google.com/g/pandoc-announce/c/H0G_Ia5_Bs0
==============================================================================

pandoc 1.12.1 and pandoc-citeproc 0.1.2.1 have now been released!

* Release notes: <http://johnmacfarlane.net/pandoc/releases.html>
* Hackage: <http://hackage.haskell.org/package/pandoc> and
<http://hackage.haskell.org/package/pandoc-citeproc>
* Binary packages: <https://code.google.com/p/pandoc/downloads/list>
and <https://github.com/jgm/pandoc/releases/tag/1.12.1>

If you use cabal to keep pandoc updated:

cabal update
cabal install pandoc pandoc-citeproc

This release fixes a few bugs (details in the changelog) and
considerably improves citation handling. The new pandoc-citeproc
can read bibtex and biblatex files directly (not using bibutils to
translate them, as before). Though this is still a work in progress,
the results are already significantly better. LaTeX constructs in
bibtex fields are translated properly, and simple math gets converted.
Thanks to Nick Bart for his continuing work towards improving
citation support, and Andrea Rossato for some important bug fixes
in the underlying citeproc-hs code.

Three changes of note:

1. The default JSON serialization format has changed.
Instead of `{"Str": "foo"}`, for example, we now have `{"t": "Str",
"c": "foo"}` ("t" for tag, "c" for contents). This new format is
easier to work with outside of Haskell. This change should
only affect people who are interacting with pandoc's JSON using
languages other than Haskell, since in Haskell the JSON conversions
can be handled automatically by the aeson library. Those who use the
python library pandocfilters for filters should upgrade to version 1.2,
which has already been updated to use the new format.

2. Pandoc's data files no longer include the javascript, CSS,
and images for S5, slidy, and slideous slide formats. If you
wish to produce S5 or slideous slides with the `--self-contained`
option, you'll need to download the appropriate code into the `s5` or
`slideous` directories, respectively, as with `revealjs`. (This is what
the User's Guide has said to do for some time.) The default for `slidy`
is to embed a link to the code on the slidy website, so nothing should
change for slidy users who are using the default template.

3. You can now create "speaker notes" in slide formats, by putting
them inside `<div class="notes">` tags. (Note that you may need to
leave a blank line before the closing `</div>` tag in some contexts.)
Currently these are supported in beamer (where the notes go to
`\note{...}`) and revealjs (where they turn into `<aside class="notes">`;
in other formats the speaker notes are just ignored.



==============================================================================
Subject: ANN: pandoc 1.12.4
From:    John MacFarlane
Date:    May 8, 2014, 7:03:54 PM
Link:    https://groups.google.com/g/pandoc-announce/c/6sNzU0Nr7nI
==============================================================================

I'm pleased to announce the release of pandoc 1.12.4.

Hackage:  https://hackage.haskell.org/package/pandoc
OSX and Windows binaries:  https://github.com/jgm/pandoc/releases/tag/1.12.4
Changelog:  http://johnmacfarlane.net/pandoc/releases

This release adds an Emacs org-mode reader (thanks to Albert
Krewinkel) and an Adobe InDesign ICML writer (thanks to mb21).

There are many other small improvements and bug fixes.  Thanks to
Matthew Pickering for extensive improvements to the textile and HTML
readers, to Neil Mayhew for improvements to the DocBook writer, and to
Jaime Marquínez Ferrándiz, CasperVector, Merijn Verstaaten, Vaclav
Zeman, Yihui Xie, Garrick Aden-Buie, and KarolS for other patches.
Thanks also to everyone who filed bug reports or participated in
discussions on pandoc-discuss.



==============================================================================
Subject: ANN: pandoc 1.12.4.2
From:    John MacFarlane
Date:    May 15, 2014, 12:27:21 AM
Link:    https://groups.google.com/g/pandoc-announce/c/l3uKFDehG1E
==============================================================================

I'm pleased to announce the release of pandoc 1.12.4.2.

Hackage: http://hackage.haskell.org/package/pandoc
Binaries: https://github.com/jgm/pandoc/releases
Changelog: http://johnmacfarlane.net/pandoc/releases.html

This is mainly a bug fix release, with a couple of minor new
features and improvements.

If you use OSX 10.7 or earlier and found that the 1.12.4 package installer
did not work, the problem should now be fixed. The zip file also contains
a perl script that will undo what the package installer does, if you decide
to remove pandoc from your system. (Thanks to Daniel Staal.)



==============================================================================
Subject: ANN: pandoc 1.13
From:    John MacFarlane
Date:    Aug 16, 2014, 6:11:56 AM
Link:    https://groups.google.com/g/pandoc-announce/c/NVMHedYfCek
==============================================================================

I'm very pleased to announce the release of pandoc 1.13!

Hackage:
https://hackage.haskell.org/package/pandoc
Release notes and OSX and Windows packages:
https://github.com/jgm/pandoc/releases

Users who install using cabal can just

cabal update && cabal install pandoc
# and pandoc-citeproc if you use it

This is an exciting release, with many new features:

* Thanks to Jesse Rosenthal, pandoc can now read Microsoft Word
documents (docx).

* Thanks to Matthew Pickering, pandoc can now read EPUB and
Txt2Tags formats.

* Thanks to Clare Macrae, pandoc can now write DokuWiki markup.

* Pandoc can now also write haddock markup, and the haddock
reader has been updated to use the same parser as haddock itself.
So pandoc can be used to create your Haskell documentation.

The Word and EPUB readers are very capable, and even translate mathematics
from the native formats (OMML and MathML) to native pandoc TeX math.
This feature is made possible by texmath 0.8, which now does tri-directional
conversion between LaTeX, OMML, and MathML. Matthew Pickering deserves
much thanks for his extensive work on this library (with help from
Jesse Rosenthal, who contributed the OMML reader, and me).

There are many, many bug fixes, API changes, and small behavior changes.
Please see the changelog for details. However, I want to call special
attention to one change which may cause existing documents to break.
The syntax for markdown definition lists has changed, bringing pandoc
in line with PHP Markdown Extra and MultiMarkdown. Previously, blank
lines were not required between definition list items; now they are.
So this style of definition list will no longer work:

term
: definition
another term
: another definition

The "tight" or "loose" status of a list item is determined by whether
there is a blank space before the definition, not by space between
items. Also, previously, the entire definition had to be indented; now,
continuation lines can be left unindented (as with other similar
constructions in markdown):

term
: definition with
lazily wrapped line.

another term
: note that this definition will not be wrapped in
paragraph tags, because it is not preceded by a blank line.

If you would like to preserve the old behavior, you can specify
`markdown+compact_definition_lists`.

Thanks to Jesse Rosenthal, Matthew Pickering, Clare Macrae, Artyom Kazak,
Albert Krewinkel, James Aspnes, Caleb McDaniel, Phillip Alday, Beni
Cherniavsky-Paskin, Matej Kollar, and Michael Thompson for contributing code or
documentation fixes to this release, and thanks to everyone who helped report
issues or suggest improvements.

John



==============================================================================
Subject: ANN: pandoc 1.13.0.1
From:    John MacFarlane
Date:    Aug 18, 2014, 3:15:47 AM
Link:    https://groups.google.com/g/pandoc-announce/c/oGAF2tIZ48U
==============================================================================

I've just released pandoc 1.13.0.1 in the usual places.

https://hackage.haskell.org/package/pandoc
https://github.com/jgm/pandoc/releases/tag/1.13.0.1

Everyone who has installed 1.13 should upgrade, as this version
fixes two serious regressions in 1.13:

* 1.13 broke lists in docx output: all lists were styled
as basic ordered lists.

* 1.13 broke pandoc-citeproc on Windows, due to a path issue.

This release fixes both of these bugs. (For a full changelog,
see https://github.com/jgm/pandoc/releases/tag/1.13.0.1.)



==============================================================================
Subject: ANN: pandoc 1.13.1
From:    John MacFarlane
Date:    Aug 31, 2014, 8:31:20 AM
Link:    https://groups.google.com/g/pandoc-announce/c/Zhdbnj0mZKU
==============================================================================

I've just released pandoc 1.13.1, which is available in the
usual places:

https://github.com/jgm/pandoc/releases/tag/1.13.1
https://hackage.haskell.org/package/pandoc

This is mostly a bug fix release. Changes are described at the github
release page, and, as usual, at http://johnmacfarlane.net/pandoc/releases.

The binary packages also include pandoc-citeproc 0.5, which
has quite a few improvements. Its changelog can be found at
https://hackage.haskell.org/package/pandoc-citeproc-0.5/changelog.

Thanks to everyone who contributed, including Jesse Rosenthal,
Matthew Pickering, Calvin Beck, Jose Luis Duran, Artyom Kazak,
lemzwerg, and Gabor Pali. Andrew Dunning was very helpful in
identifying bugs in pandoc-citeproc.



==============================================================================
Subject: ANN: pandoc 1.13.2
From:    John MacFarlane
Date:    Dec 20, 2014, 9:53:57 AM
Link:    https://groups.google.com/g/pandoc-announce/c/aC1hnNSDh_M
==============================================================================

I'm pleased to announce the release of pandoc 1.13.2.
It is available in the usual places:

Hackage: https://hackage.haskell.org/package/pandoc
Binary packages: https://github.com/jgm/pandoc/releases/tag/1.13.2

Note that, for the first time, we are providing a linux binary package
(64-bit Debian/Ubuntu) in adddition to Windows and OSX. This is
necessary because the official Debian package is so far behind.

This is mainly a "spit and polish" release, with a large number
of bug fixes and minor improvements. A full change log can be
seen here: http://pandoc.org/releases. Of special note is a new TWiki
reader, contributed by Alexander Sulfrian.

Thanks to everyone who submitted bug reports or contributed patches.
Contributors include Daniel Bergey, Matthew Pickering, Jesse Rosenthal,
Bryan O'Sullivan, Caleb McDaniel, Nikolay Yakimov, Albert Krewinkel,
Timothy Humphries, Vaclav Zeman, Bjorn Buckwalter, Todd Sifleet, Grégory
Bataille, Mark Szepieniec, and Jason Ronallo.



==============================================================================
Subject: ANN: pandoc 1.14
From:    John MacFarlane
Date:    May 28, 2015, 7:37:29 AM
Link:    https://groups.google.com/g/pandoc-announce/c/x8MAFcXFwLE
==============================================================================

pandoc 1.14 has been released! It includes a CommonMark reader and
writer, along with many improvements to the existing readers and
writers. All of the changes are described at
<https://github.com/jgm/pandoc/releases/tag/1.14>. Those who use binary
packages can find them there, too. Those who install pandoc via cabal
can upgrade from Hackage in the usual way.

The binary packages also come with a new, improved version of
pandoc-citeproc.

Note that the API has changed: the readers now return
Either PandocError Pandoc, instead of raising on error when
the input can't be parsed.

If you use a custom latex or beamer template, you will need to
update it, since pandoc now uses a custom `\tightlist` command
to make lists "tight."

Thanks to all who contributed, including Albert Krewinkel, Alfred
Wechselberger, Andreas Lööw, Caleb McDaniel, Craig S. Bosma, Greg
Rundlett, Grégory Bataille, Hans-Peter Deifel, J. Lewis Muir, Jesse
Rosenthal, John MacFarlane, John MacFarlane, Jose Luis Duran, Julien
Cretel, Konstantin Zudov, Mark Wright, Mathias Schenner, Matthew
Pickering, Matthias C. M. Troffaes, Nikolay Yakimov, Philippe
Ombredanne, RyanGlScott, Shahbaz Youssefi, Sumit Sahrawat, Tim Lin, Tom
Leese, gohai, mb21, and Nick Bart.



==============================================================================
Subject: ANN: pandoc 1.14.0.1
From:    John MacFarlane
Date:    May 29, 2015, 6:43:42 AM
Link:    https://groups.google.com/g/pandoc-announce/c/KUf0WkcNLu4
==============================================================================

There was a glitch in the build process for pandoc 1.14 that resulted
in Windows binaries incapable of producing docx or odt files.

I have just uploaded a new release, 1.14.0.1, that fixes the problem.
Anyone who installed 1.14 using the msi should definitely install
1.14.0.1.

https://github.com/jgm/pandoc/releases/tag/1.14.0.1



==============================================================================
Subject: ANN: pandoc 1.14.1
From:    John MacFarlane
Date:    Jul 1, 2015, 7:54:36 AM
Link:    https://groups.google.com/g/pandoc-announce/c/RorAsuhXbrw
==============================================================================

I'm pleased to announce the release of pandoc 1.14.1.

A changelog and binary downloads can be found here:
https://github.com/jgm/pandoc/releases/1.14.1

If you use cabal to install pandoc, just

cabal update && cabal install --reinstall pandoc

In general this release just cleans up a few problems
with the 1.14.0.x series.

You can once again put a reference.docx in your ~/.pandoc
directory, and it will override defaults. You can also
once again do `pandoc --print-default-data-file
reference.docx`.

`--self-contained` should also work better with complex
CSS files.

Packagers take note: the man pages are no longer built
during the Cabal build process. Instead, pandoc can now
generate its own man pages:

pandoc --man1 > pandoc.1
pandoc --man5 > pandoc_markdown.5



==============================================================================
Subject: ANN: pandoc 1.15
From:    John MacFarlane
Date:    Jul 1, 2015, 10:50:45 PM
Link:    https://groups.google.com/g/pandoc-announce/c/1S3nWe-CFWE
==============================================================================

I've released pandoc 1.15:
https://github.com/jgm/pandoc/releases/tag/1.15

This change mostly just improves on the man page generation.
There is now a single man page, not two, and it is generated
using pandoc + some custom templates and filters after
pandoc is built. (Pandoc need not be installed to do this.)
The --man1 and --man5 options that were added the other day
have been removed, as has Text.Pandoc.ManPages (hence the
major version bump).

ConTeXt users will also want to update, because of a fix
in how internal links are rendered.



==============================================================================
Subject: ANN: pandoc 1.15.0.1
From:    John MacFarlane
Date:    Jul 2, 2015, 4:21:07 AM
Link:    https://groups.google.com/g/pandoc-announce/c/Z23oKobOyRU
==============================================================================

I've released pandoc 1.15.0.1.

https://github.com/jgm/pandoc/releases/1.15.0.1

The change only affects man page building. Hopefully this
will be the last iteration!

Now man pages are built in the cabal build process, and
installed with cabal copy or install.

This should make things easy for both packagers and
users who install pandoc using cabal.



==============================================================================
Subject: ANN: pandoc 1.15.0.2
From:    John MacFarlane
Date:    Jul 2, 2015, 5:20:15 PM
Link:    https://groups.google.com/g/pandoc-announce/c/IEYPY_t9nhQ
==============================================================================

I've released pandoc 1.15.0.2 on Hackage.

https://github.com/jgm/pandoc/releases/tag/1.15.0.2

This just fixes a packaging bug which kept 1.15.0.1 from
installing (missing extra-source-files for creating the man
page). Apologies for all the churn.



==============================================================================
Subject: ANN: pandoc 1.15.0.4
From:    John MacFarlane
Date:    Jul 3, 2015, 8:43:54 PM
Link:    https://groups.google.com/g/pandoc-announce/c/f0wmSMuexnw
==============================================================================

I've released pandoc 1.15.0.4.
This mostly just fixes man-page building issues.
https://github.com/jgm/pandoc/releases/1.15.0.4



==============================================================================
Subject: ANN: pandoc 1.15.0.5
From:    John MacFarlane
Date:    Jul 10, 2015, 9:34:28 PM
Link:    https://groups.google.com/g/pandoc-announce/c/BVGD-sTwN14
==============================================================================

I've just released pandoc 1.15.0.5
https://github.com/jgm/pandoc/releases/tag/1.15.0.5

This comes with new binary packages.

It fixes a potential security issue with javascript email
obfuscation (the default with the HTML writer).

And, thanks to nkalvi's work, we have a much improved Windows
installer.

Other changes are described in the changelog.



==============================================================================
Subject: ANN: pandoc 1.15.0.6
From:    John MacFarlane
Date:    Jul 15, 2015, 9:08:55 PM
Link:    https://groups.google.com/g/pandoc-announce/c/5jcYi9y3iiw
==============================================================================

I've released pandoc 1.15.0.6:
https://github.com/jgm/pandoc/releases/1.15.0.6

This fixes a serious regression in `--self-contained`,
improves detection of URIs with `markdown+autolink_bare_uris`,
and fixes some other bugs.



==============================================================================
Subject: ANN: pandoc 1.15.1
From:    John MacFarlane
Date:    Oct 16, 2015, 7:17:54 PM
Link:    https://groups.google.com/g/pandoc-announce/c/C6arL719e-Y
==============================================================================

I'm pleased to announce the release of pandoc 1.15.1.

It is available as usual on Hackage, and binary packages
for OSX, Windows, and 64-bit linux can be found at
https://github.com/jgm/pandoc/releases/tag/1.15.1

A list of changes can be found here:
http://pandoc.org/releases.html

Those who install from source may now use either cabal
or stack.

Some highlights of this release include:

- A new reader for the ODT format.

- More consistent handling of languages: setting the
`lang` metadata variable with a value in BCP47 format
(e.g., `en_US`) will now work in all output formats.

- Support for bidirectional text output in XeLaTeX,
ConTeXt, and HTML/EPUB.

Thanks to all who contributed, and especially to MarLinn
for the ODT reader; to Ophir Lifshitz for many improvements
to the readers; and to mb21, Nick Bart, and Andrew
Dunning for their work on improving language support.



==============================================================================
Subject: ANN: pandoc 1.15.2
From:    John MacFarlane
Date:    Nov 15, 2015, 11:39:30 PM
Link:    https://groups.google.com/g/pandoc-announce/c/D49s_Dw4TYY
==============================================================================

I've just released pandoc 1.15.2:

Hackage: https://hackage.haskell.org/package/pandoc-1.15.2
Github: https://github.com/jgm/pandoc/releases/tag/1.15.2

A changelog and binary packages for Windows, OSX, and 64-bit linux
can be found on the github release page.

Some highlights:

- ability to use ConTeXt rather than LaTeX in creating PDFs
- emoji markdown extension
- relative cell widths in pipe tables, fixing issues using
them with LaTeX/PDF
- fixed --self-contained with CSS containing data URIs
- support start number in textile ordered lists (writer
only)
- support Spans and Divs with lang attributes in LaTeX/ConTeXt
- many improvements to org reader
- fixed links in footnotes in docx reader
- fixed raw HTML parsing bugs in Markdown and HTML
- fixed internal links in LaTeX/PDF
- added a way to link to external resources in EPUBs, rather
than inclding them in the EPUB container
- lots of cleaning up in LaTeX and ConTeXt templates;
new default is not to color links

Thanks to all who contributed, and particularly to Albert
Krewinkel, Jesse Rosenthal, Andrew Dunning, and mb21.



==============================================================================
Subject: ANN: pandoc 1.16
From:    John MACFARLANE
Date:    Jan 3, 2016, 8:01:19 AM
Link:    https://groups.google.com/g/pandoc-announce/c/X-Q0lM4Z7WE
==============================================================================

Happy New Year! I'm pleased to announce pandoc 1.16.
It is available in the usual places. A full changelog and
binaries for Windows, OSX, and 64-bit Linux can be found at

https://github.com/jgm/pandoc/releases/tag/1.16

Thanks to Mauro Bieg, we can now specify attributes (including
image sizes) for Markdown links and images. I can't count
the number of requests for this feature over the years.
This feature is attached to the extension link_attributes
(enabled by default in pandoc's Markdown). The old
link_attributes extension has been renamed as
mmd_link_attributes.

A SoftBreak constructor has been added to the Inline type.
This allows us to keep track of where line breaks occured
in the source, even when they aren't semantically
significant, and reproduce them in our output. The
old --no-wrap option has been deprecated, and now we have
a threefold distinction. --wrap=auto (the default) does
what pandoc has always done by default, hard-wrapping lines
to fit a column width. --wrap=none does what --no-wrap used
to do. --wrap=preserve inserts hard breaks where they
occur in the source text.

These changes require a new version of pandoc-types (1.16).

writerDpi has been added to WriterOptions; it can be set
using the new --dpi option (both added by Mauro Bieg).
This affects conversion between pixels and real dimensions
for image sizes.

--smart and --no-tex-ligatures have been rationalized
(see the full description and examples in the changelog).

A new east_asian_line_breaks extension has been added.
This is like ignore_line_breaks, but smarter: it only
ignores line breaks when they occur between tow East Asian
wide characters. This is helpful when your text contains a
mix of East Asian and non-East Asian scripts.

PDFs can now be created via wkhtmltopdf (as well as via
pdflatex, lualatex, xelatex, and context). To do this,
specify -t html5 and use -o with a pdf output file.
If you have math, you can add --mathjax.

All writers now fill a meta-json variable with a JSON
version of the metadata (with fields formatted by the
writer). This should make it dead easy for static site
generators to get the metadata out of pandoc documents.

There are many other bug fixes and minor improvements,
including many changes to the beamer, LaTeX, ConTeXt,
and HTML slide show changes. If you use customized
templates, you should review the changelog and update
the templates as necessary. Big thanks to Andrew Dunning
and Thomas Hodgson for their attention to detail here.

Thanks to Andreas Lööw, Andrew Dunning, Jesse Rosenthal,
Raniere Silva, Thomas Hodgson, Mauro Bieg, and
miachelbeaumont, Paolo Rodríguez, Lev Walkin, Vaughn
Iverson, and xavier Olive for contributing patches, and to
everyone who contributed bug reports and suggestions.

John MacFarlane
unread,
Jan 4, 2016, 5:03:10 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com
There was a problem with the version of pandoc-citeproc
included in the binary packages originally uploaded for
the pandoc-1.16 release. (The data files were not properly
embedded.)

If you have already installed pandoc 1.16 from a binary
package, please get the new version of the package from

https://github.com/jgm/pandoc/releases/tag/1.16

and install it. (The new versions have different filenames:
pandoc-1.16-1-osx.pkg, pandoc-1.16-1-windows.msi,
pandoc-1.16-2-amd64.deb.)

John MACFARLANE
unread,
Jan 7, 2016, 8:12:22 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com
There was *still* a problem with the debian package, which
didn't have the right version of pandoc-citeproc.

I have now uploaded a new debian package

https://github.com/jgm/pandoc/releases/download/1.16/pandoc-1.16-3-amd64.deb

and fixed the package-generating script. Sorry for the trouble.

+++ John MacFarlane [Jan 04 16 08:02 ]:


>There was a problem with the version of pandoc-citeproc
>included in the binary packages originally uploaded for
>the pandoc-1.16 release. (The data files were not properly
>embedded.)
>
>If you have already installed pandoc 1.16 from a binary
>package, please get the new version of the package from
>
>https://github.com/jgm/pandoc/releases/tag/1.16
>
>and install it. (The new versions have different filenames:
>pandoc-1.16-1-osx.pkg, pandoc-1.16-1-windows.msi,
>pandoc-1.16-2-amd64.deb.)
>

>--
>You received this message because you are subscribed to the Google Groups "pandoc-announce" group.
>To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-announ...@googlegroups.com.
>To post to this group, send email to pandoc-...@googlegroups.com.
>Visit this group at https://groups.google.com/group/pandoc-announce.
>For more options, visit https://groups.google.com/d/optout.



==============================================================================
Subject: ANN: pandoc 1.16.0.1
From:    John MacFarlane
Date:    Jan 11, 2016, 3:11:10 AM
Link:    https://groups.google.com/g/pandoc-announce/c/nQMhV2CRamI
==============================================================================

I've released pandoc 1.16.0.1.

Changelog and binary packages are available at

https://github.com/jgm/pandoc/releases/tag/1.16.0.1

This just fixes a few bugs in 1.16.



==============================================================================
Subject: ANN: pandoc 1.16.0.2
From:    John MacFarlane
Date:    Jan 14, 2016, 6:13:28 AM
Link:    https://groups.google.com/g/pandoc-announce/c/6uZ2gmhFv18
==============================================================================

I've released a small update, pandoc 1.16.0.2.
Changelog and binaries here:

https://github.com/jgm/pandoc/releases/tag/1.16.0.2

This release just does two things:

- removes a deepseq dependency that was blocking
inclusion of pandoc in the latest stackage
- fixes a bad regression in smart quote parsing in
LaTeX, which could, in some cases, lead to the
silent loss of part of a paragraph.

Both issues were pressing enough to warrant a new release.



==============================================================================
Subject: ANN: pandoc 1.17
From:    John MacFarlane
Date:    Mar 20, 2016, 6:04:09 PM
Link:    https://groups.google.com/g/pandoc-announce/c/MBAdRQsMR_0
==============================================================================

I've released pandoc 1.17. Release notes and
binary packages can be found on the github release page:

https://github.com/jgm/pandoc/releases/tag/1.17

Thanks to all who contributed, and especially to Jesse Rosenthal,
Chris Forster, Mauro Bieg, and Albert Krewinkel.

Highlights of this release:

* A new output format, tei, contributed by Chris Forster.
TEI Simple is an XML format for archiving books.

* A new --file-scope option contributed by Jesse Rosenthal.
By default pandoc concatenates input files before parsing;
with --file-scope, it will parse each file individually,
and then combine the parsed contents. This is helpful
for some applications.

* Many performance improvements and bug fixes.

API changes:

* Added writeTEI
* Added a general ByteStringReader with warnings, used by
the docx reader
* Added readDocxWithWarnings
* Changed type of Shared.uniqueIdent argument from [String]
to Set String



==============================================================================
Subject: ANN: pandoc 1.17.0.1
From:    John MacFarlane
Date:    Mar 22, 2016, 2:50:49 AM
Link:    https://groups.google.com/g/pandoc-announce/c/atutYYj7CIg
==============================================================================

I've uploaded pandoc 1.17.0.1 to Hackage and the github
release site:
https://github.com/jgm/pandoc/releases/tag/1.17.0.1

This just fixes a serious regression in 1.17, which affects
`pandoc -f json` when used with input from stdin (e.g. in
a pipe). (This has to do with the "file scope" changes.)
I recommend that everyone upgrade, but if you never use json
input, then it's not urgent.

Thanks to Fedor Sheremetyev for noticing the bug and
Jesse Rosenthal for fixing it.



==============================================================================
Subject: ANN: pandoc 1.17.0.2
From:    John MacFarlane
Date:    Mar 23, 2016, 4:41:31 PM
Link:    https://groups.google.com/g/pandoc-announce/c/5-7lSWtzvdU
==============================================================================

I've released pandoc 1.17.0.2, which fixes a serious
regression in 1.17. (The bug caused newlines to be
omitted in some literal HTML blocks in Markdown.)

It is available on Hackage and at
https://github.com/jgm/pandoc/releases/tag/1.17.0.2

I recommend that everyone who installed one of
the other 1.17.x versions upgrade. Sorry for the churn!



==============================================================================
Subject: ANN: pandoc 1.17.1
From:    John MacFarlane
Date:    Jun 5, 2016, 5:16:43 AM
Link:    https://groups.google.com/g/pandoc-announce/c/uszPO5f6Ci4
==============================================================================

I'm pleased to announce the release of pandoc 1.17.1.
For a detailed changelog and binary packages for OSX,
Windows, and Linux, see

https://github.com/jgm/pandoc/releases/tag/1.17.1

Highlights of this release:

- new docbook5 output format, specialized to DocBook v5
- enhanced org-mode reader and writer suppport
- improved spacing in LaTeX/PDF tables
- improved math support, due to use of texmath 0.8.6.2 and
new MathJax configuration
- many bug fixes and minor improvements.
- compiles with ghc 8.0.1

Thanks to everyone who contributed, and especially to
Ivo Clarysse for the docbook5 support and to Albert
Krewinkel for his hard work on the org-mode reader and
writer.



==============================================================================
Subject: ANN: pandoc 1.17.2
From:    John MacFarlane
Date:    Jul 17, 2016, 6:57:33 PM
Link:    https://groups.google.com/g/pandoc-announce/c/VyxOvLhRoM0
==============================================================================

I'm pleased to announce the release of pandoc 1.17.2,
available at the usual places.

A changelog and binary packages can be found at the
GitHub release site:
https://github.com/jgm/pandoc/releases/tag/1.17.2
The binary packages also include the latest version
of pandoc-citeproc, 0.10.1.

Highlights include a new Zim Wiki writer (due to Alex
Ivkin) and extensive improvements to org-mode and docx
support, due to Albert Krewinkel and Jesse Rosenthal,
respectively.

Note the change in default email obfuscation method.
Previously email links were obfuscated with JavaScript
by default; the new default is not to obfuscate. To
get the old behavior, use `--email-obfuscation=javascript`.



==============================================================================
Subject: ANN: pandoc 1.18
From:    John MacFarlane
Date:    Oct 27, 2016, 12:46:58 AM
Link:    https://groups.google.com/g/pandoc-announce/c/pG7WJkL6jiE
==============================================================================

I'm pleased to announce the release of pandoc 1.18.
Binary packages and a changelog can be found at:
https://github.com/jgm/pandoc/releases/tag/1.18
The source code and API documentation is on HackageDB:
https://hackage.haskell.org/package/pandoc

As usual, there are lots of bug fixes and small improvements.
Thanks to everyone who participated! Here are some of the more
major changes:

Changes in command-line options
-------------------------------

--list-input-formats, --list-output-formats, --list-extensions,
--list-highlight-languages, and --list-highlight-styles.

--version output no longer lists highlighting languages (for
that, use the new --list-highlight-languages). It now lists
the pandoc-types version against which pandoc was compiled.

--help output no longer lists input and output formats (for
that, use the new --list-input-formats and --list-output-formats).

New option: --reference-location=block|section|document
(Jesse Rosenthal). This only affects the Markdown writer. It
determines where reference link definitions and footnotes will
be placed.

New option: --top-level-division=section|chapter|part (Albert
Krewinkel). This determines what a level-1 header corresponds to in LaTeX,
ConTeXt, DocBook, and TEI output. The default is section.

--chapters has been deprecated in favor of --top-level-division=chapter.

Changes in underlying pandoc types
----------------------------------

A new LineBlock constructor has been added to Block (Albert
Krewinkel). This is used for RST and Markdown line blocks, DocBook
linegroup/line combinations, and org-mode VERSE blocks.
Text.Pandoc.Builder now exports lineBlock.

Changes in JSON serialization
-----------------------------

The JSON serialization has been changed (Jesse Rosenthal). We no
longer rely on aeson's generic encoding, which can vary with
the aeson version. The toplevel JSON format is now

{"pandoc-api-version" : [MAJ, MIN, REV], "meta" : META, "blocks": BLOCKS}

instead of

[{"unMeta": META}, [BLOCKS]]

And leaf nodes no longer have an empty array for their "c" value.
Thus, for example, a `Space` is encoded as `{"t":"Space"}`
rather than `{"t":"Space","c":[]}` as before.

Authors of filters may need to make changes so that their
filters will work with the new JSON format.

New markdown extensions
-----------------------

bracketed_spans (enabled by default) allows you to create
a native span using the syntax [My span]{#id .class key="val"}.

angle_brackets_escapable allows < and > to be backslash-escaped
(this is used in markdown_github, which does not allow all
symbols to be backslash-escaped, as pandoc's Markdown does, but
uses a slightly different list than original Markdown).

Filter changes
--------------

You can now put filters in $DATADIR/filters; pandoc will
look there for filters before looking in the path (Jesse
Rosenthal).

Improvements in readers and writers
-----------------------------------

See the changelog. Thanks especially to Albert Krewinkel for
many improvements to the org-mode reader, to Jesse Rosenthal for
improving the docx reader, and to Hubert Plociniczak for improving
the ODT reader.



==============================================================================
Subject: ANN: pandoc 1.19
From:    John MacFarlane
Date:    Dec 1, 2016, 1:10:44 AM
Link:    https://groups.google.com/g/pandoc-announce/c/OJXpYEOUPHw
==============================================================================

I'm pleased to announce the release of pandoc 1.19.

Hackage: https://hackage.haskell.org/package/pandoc
Changelog and Binary packages: https://github.com/jgm/pandoc/releases/tag/1.19

There are some API changes that will affect people
using pandoc as a Haskell library.

Other changes are mostly minor improvements.
See the changelog for details.

Thanks to everyone who contributed!



==============================================================================
Subject: ANN: pandoc 1.19.1, and plans for 2.0
From:    John MacFarlane
Date:    Dec 10, 2016, 3:55:40 PM
Link:    https://groups.google.com/g/pandoc-announce/c/AAr-yQ0t55c
==============================================================================

I've just released pandoc 1.19.1 in the usual places:

Hackage (source & API docs):
https://hackage.haskell.org/package/pandoc

GitHub (binary packages & changelog):
https://github.com/jgm/pandoc/releases/tag/1.19.1

The main reason for the release (so soon after 1.19)
is to fix a serious regression in the HTML reader
affecting tables. I recommend that anyone who is
using 1.19 upgrade to 1.19.1.

There are a few other minor improvements as well.

An update on plans for pandoc 2.0
---------------------------------

Jesse Rosenthal and I have been working on a restructuring
of the pandoc API. This will be pandoc 2.0.

Let me explain the point of the change. Currently pandoc
has some writers that are "pure" (they can't do IO) and
others that are not. (In Haskell, it's built into the type
of a function whether it can do IO.) For example, the
HTML writer is pure, while the docx writer does IO.
All of the readers are pure.

In some contexts, there are big advantages to purity. For
example, if you're using pandoc in a web application and you
use a pure function, you can have confidence that it isn't
going to write to or read from your file system. And pure
readers and writers are easy to parallelize and to
test deterministically.

But purity can also make things difficult. For example,
LaTeX documents can include other files using \include
or \input or \usepackage. Pandoc's LaTeX reader is pure,
so it can't just open these files and parse them.
Instead we have to use a hack, preprocessing the file
and doing these transclusions before passing the contents
to the LaTeX reader.

Ideally, we could choose to run each reader or writer
in "pure" or in "IO" mode, as our application requires.
Running in "pure" mode imposes certain limitations: for
example, includes can't be processed (unless we supply
a virtual directory up front). But it also has certain
advantages, as noted above.

In pandoc 2.0 you'll be able to use each reader or writer
either as a pure function (with runPure) or in IO (with
runIO). That's the main architectural change.

Those who use pandoc as a library will have to make some
minor changes in how they call pandoc's functions.

Those who use the command line program will see improvements
in things like include file processing and better warnings.

Anyway, that's a preview of what's to come. I'm hoping
that maybe this will be the next release of pandoc, but if
another bad regression emerges I may need to do another
release in the 1.x series.



==============================================================================
Subject: ANN: pandoc 1.19.2
From:    John MacFarlane
Date:    Jan 29, 2017, 10:04:54 PM
Link:    https://groups.google.com/g/pandoc-announce/c/cLYcrrHBMDc
==============================================================================

I've released pandoc 1.19.2. This is really just a bug-fix
release, with no significant new features.

Binary packages and a changelog can be found at
https://github.com/jgm/pandoc/releases/tag/1.19.2

Thanks to everyone who contributed!

John MacFarlane
unread,
Feb 3, 2017, 11:02:16 AM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com
I've released a small update, 1.19.2.1. This just fixes some
packaging issues, so unless you had trouble installing
pandoc 1.19.2, there's no particular reason to upgrade.



==============================================================================
Subject: ANN: pandoc 2.0
From:    John MacFarlane
Date:    Oct 30, 2017, 1:16:56 AM
Link:    https://groups.google.com/g/pandoc-announce/c/DgkoPlTx9uo
==============================================================================

I'm delighted to announce the release of pandoc 2.0.
Binary packages and a changelog can be found at
<https://github.com/jgm/pandoc/releases/tag/2.0>. The source
code and API documentation is on Hackage:
<https://hackage.haskell.org/package/pandoc>.

This is a huge release: describing all the changes takes over
11,000 words in the changelog. All users should look at the
"new features" and "behavior changes" sections of the
changelog. Those who use pandoc as a library should also look
at the "API changes" section. And anyone who works with a
particular format should look at the "bug fixes" section
for relevant to that format.

Some highlights:

- New output formats: ms (groff ms), jats (JATS XML), gfm (a
version of GitHub-Flavored Markdown that uses the same
parser as GitHub for maximum accuracy), muse (Emacs Muse).

- New input formats: gfm, muse, tikiwiki (TikiWiki),
vimwiki (Vimwiki), creole (Creole 1.0).

- A plain-text syntax for Divs (arbitrary block containers).

- A syntax for passing through raw content in any format.

- Much improved support for LaTeX input, especially
in handling macros and included files.

- PDFs can now be produced via pdfroff, prince, and weasyprint,
in addition to latex, xelatex, lualatex, context, and
wkhtmltopdf.

- A new way of writing pandoc filters in lua, using the lua
interpreter that is built into pandoc. Lua filters are
generally much faster than JSON filters (since we avoid
the expense of converting to and from JSON), and they have
the advantage that they do not require any software besides
pandoc itself to be installed.

- Better error handling, warnings and informational messages.

- New command-line options:

--eol (specifies line endings),
--log (prints JSON representation of info and warning messages),
--request-header (allows specifying a header to be used when
pandoc fetches external resources),
--lua-filter (for running lua filters, see below),
--epub-subdirectory (for changing the directory used in epub
containers),
--resource-path (for setting the search path for images and
other resources),
--abbreviations (for specifying a custom abbreviations
file so that the Markdown parser can be sensitive to
abbreviations),
--syntax-definition (allowing XML syntax highlighting definitions
to be loaded dynamically).

- Changed command-line options:

--reference-doc replaces --reference-docx and --reference-odt
--smart removed (instead use +smart on reader and/or writer)
--normalize removed (normalization is automatic)
--latex-engine removed (instead use --pdf-engine)
--parse-raw removed (instead use -f latex+raw_tex or -f html+raw_html)
--epub-stylesheet removed (instead use --css)
--mathml no longer takes an argument

The focus of this release was a major architectural change
that will be largely invisible to users of the pandoc program,
but that is responsible for many of the improvements users
will notice. Previously, most of the pandoc readers and
writers were "pure" functions: they converted between strings
and a Pandoc data structure, without being able to perform IO
operations. This purity has significant advantages in many
contexts, but it also makes it difficult to do things like
process included files. We have changed the types of all the
readers and writers so that users can now select whether
they will have access to IO.

With each release, pandoc becomes more a team effort, with more
contributors committing high-quality code. Special thanks are
due to Jesse Rosenthal, who designed and initiated the large
architectural change described above; Albert Krewinkel,
who added the lua filters and improved the Org reader, as well
as helping with the API reorganization; Alexander Krotov,
who contributed the Muse reader and writer and improved the
FB2 writer; Andrew Dunning, Vaclav Haisman, Xavier Olive, and
Thomas Hodgson, who improved the LaTeX, ConTeXt, and beamer
templates; Kolen Cheung, who improved documentation and
infrastructure (pandoc-nightly); Marc Schreiber, who improved
the LaTeX reader; Mauro Bieg, who improved the LaTeX reader and
image size code, and added PDF generation via weasyprint and
prince; Sascha Wilde, who added the Creole reader; Yuchen Pei,
who added the Vimwiki reader; hftf, who brought consistency to
the readers' handling of underlining; and rlpowell, who added the
TikiWiki reader. Many others contributed code, bug reports, or
suggestions. Without this large and cooperative community, pandoc
would be a far less capable tool.

Happy converting!



==============================================================================
Subject: ANN: pandoc 2.0.0.1
From:    John MACFARLANE
Date:    Oct 31, 2017, 7:06:09 AM
Link:    https://groups.google.com/g/pandoc-announce/c/-M0iVIs_nTU
==============================================================================

I'm pleased to announce the release of pandoc 2.0.0.1
in the usual places:

https://github.com/jgm/pandoc/releases/tag/2.0.0.1
https://hackage.haskell.org/package/pandoc

This release fixes a couple regressions (involving LaTeX
input and EPUB output) and some packaging issues
in pandoc 2.0.



==============================================================================
Subject: ANN: pandoc 2.0.1
From:    John MacFarlane
Date:    Nov 1, 2017, 6:39:31 AM
Link:    https://groups.google.com/g/pandoc-announce/c/OCE0pgxMSEM
==============================================================================

I've released pandoc 2.0.1 to fix a few more regressions in 2.0.

Binaries and changelog: https://github.com/jgm/pandoc/releases
Hackage: https://hackage.haskell.org/package/pandoc

I recommend that everyone who installed an earlier version
of pandoc 2.0.x upgrade.



==============================================================================
Subject: ANN: pandoc 2.0.1.1
From:    John MacFarlane
Date:    Nov 5, 2017, 7:22:02 AM
Link:    https://groups.google.com/g/pandoc-announce/c/-vTl7uSN4vk
==============================================================================

Only six years behind schedule: pandoc 2011!

Binaries and changelog:
https://github.com/jgm/pandoc/releases/tag/2.0.1.1
Source code and API docs:
https://hackage.haskell.org/package/pandoc

This is a bug fix release, smoothing a few more
rough edges from the 2.0 release.

I recommend that everyone who installed an earlier
2.0.x release upgrade to this release.



==============================================================================
Subject: ANN: pandoc 2.0.2
From:    John MacFarlane
Date:    Nov 12, 2017, 7:18:38 PM
Link:    https://groups.google.com/g/pandoc-announce/c/UaqFMfpkKQo
==============================================================================

I'm pleased to announce pandoc 2.0.2. This fixes a few
more regressions that came from the big transition to 2.0.

Source/API docs: https://hackage.haskell.org/package/pandoc
Binaries/changelog: https://github.com/jgm/pandoc/releases

These regressions involve the --metadata flag, EPUB
generation, JATS generation when using pandoc-citeproc, and
fenced code blocks inside list items. So I recommend that
everyone who cares about any of these things upgrade now.

One new feature is that you can now use `walk_inline` and
`walk_block` within a lua filter, to run a lua filter on
a particular element (useful, for example, if you want to
capitalize text within headers). For an example (which
shows how easy lua filters are), see the filter we now use
to generate the pandoc man page. This filter capitalizes
text in level-1 headers, removes notes, and replaces links
with plain text:

https://github.com/jgm/pandoc/blob/master/man/manfilter.lua

We are also now providing an alternative to the msi package
installer for Windows users: a zip file containing the
pandoc and pandoc-citeproc executables and documentation.



==============================================================================
Subject: ANN: pandoc 2.0.3
From:    John MacFarlane
Date:    Nov 21, 2017, 6:43:03 AM
Link:    https://groups.google.com/g/pandoc-announce/c/CdvaB7Fxmj8
==============================================================================

I've released pandoc 2.0.3:

Source and API docs:
https://hackage.haskell.org/package/pandoc
Binary packages and changelog:
https://github.com/jgm/pandoc/releases/tag/2.0.3

This is another bug-fix release, cleaning up another
regression in the EPUB writer and making some other
minor improvements. See the changelog for details.



==============================================================================
Subject: ANN: pandoc 2.0.4
From:    John MacFarlane
Date:    Dec 4, 2017, 7:40:57 AM
Link:    https://groups.google.com/g/pandoc-announce/c/i-ndU2WRwF0
==============================================================================

I'm pleased to announce the release of pandoc 2.0.4.

Source code:
https://hackage.haskell.org/package/pandoc
Binary packages and changelog:
https://github.com/jgm/pandoc/releases/tag/2.0.4

Among the more noteworthy changes:

* New --print-highlight-style option, which makes it
easier to create modified highlighting themes to use
with --highlight-style.

* The default behavior of the docx reader has changed,
so that empty paragraphs are no longer ignored.
If you want to ignore them as before, use the new
--strip-empty-paragraphs option.

* --webtex can now be used with gfm output.

* Native spans and divs will now produce HTML span
and div tags in gfm output, which is needed for
using pandoc-citeproc.

* The HTML writer now exports tagWithAttributes, which
can be used by other writers.

* CSS is included in default HTML-based templates so
that spans with class 'underline' will display
underlined. (Readers parse underlined text as such
spans.)

* Lua filters: a new List module makes it easier to
deal with lists.

* A fix in the skylighting library restores correct
default colors in code blocks with line numbering,
and fixes some invalid HTML that was previously
being generated.

* We now provide alternative zip containers for Windows,
macOS, and Linux binaries, for those who prefer them
to the native package installers.

* Thanks to some changes by Jasper Van der Jeugt,
it should now take less time and memory to compile
pandoc.

Thanks to all who contributed, especially Alexander Krotov,
Albert Krewinkel, and Mauro Bieg.



==============================================================================
Subject: ANN: pandoc 2.0.5
From:    John MacFarlane
Date:    Dec 13, 2017, 7:06:40 AM
Link:    https://groups.google.com/g/pandoc-announce/c/HnCElxiu5-k
==============================================================================

I'm pleased to announce the release of pandoc 2.0.5:

https://github.com/jgm/pandoc/releases/tag/2.0.5
https://hackage.haskell.org/package/pandoc

This release fixes a few bugs in 2.0.4:

* The highlighting themes produced with `--print-highlight-style`
will now actually work with `--highlight-style`...so customize away!
* We've improved formatting for highlighted code in HTML (especially
with line numbers), thanks to David Baynard's work on skylighting.
* If you use `--pdf-engine-opt` multiple times, the order of
options will now be preserved.
* A backslash before a newline is now correctly parsed in
the LaTeX reader.
* Processing instructions can be included as raw HTML in
Markdown.
* We no longer parse a native div after a table as a caption
in Markdown.

In addition, there are some new features:

* Pandoc can now output PowerPoint slide shows, thanks to Jesse
Rosenthal.
* A new `empty_paragraphs` extension replaces the
`--strip-empty-paragraphs` option that was added in 2.0.4.
This can be enabled if you want to allow empty paragraphs
in the docx reader and writer, OpenDocument writer,
and HTML reader and writer.
* We avoid creating overly narrow tables when pipe tables
have extra-long lines and narrow header lines.
* Users of lua filters can now override the default
initialization for the Lua interpreter, e.g. to enable
libraries to use in all filters, or extend the default
modules (thanks to Albert Krewinkel).

For a complete list of changes, see the changelog.



==============================================================================
Subject: ANN: pandoc 2.0.6
From:    John MacFarlane
Date:    Dec 29, 2017, 1:51:38 AM
Link:    https://groups.google.com/g/pandoc-announce/c/tY-ulr06XtQ
==============================================================================

I've released pandoc 2.0.6 at the usual places:

https://github.com/jgm/pandoc/releases/tag/2.0.6
https://hackage.haskell.org/package/pandoc

This is mostly a bug-fix release: see the changelog
for a full description of changes.

Here are a few noteworthy changes:

- `jats` is now supported as an input format, as well
as as output format, thanks to Hamish Mackenzie.

- `--list-extensions` can now take an optional format
argument; you can use it to see which extensions
are enabled or disabled by default for a format.

- Markdown example lists always obey the four-space
rule, rather than the new indentation rules. This
is because their labels are often quite wide.

- The `latex_macros` extension now behaves a bit
differently. If it is set, then macros will be
applied not just to math, as currently, but to all
raw latex in the document, and the macro definitions
will not be passed through as raw latex. Users
targeting latex or PDF output should probably use
`markdown-latex_macros` to disable application of
macros by the markdown reader.

Thanks to all who contributed to this release!



==============================================================================
Subject: ANN: pandoc 2.1
From:    John MacFarlane
Date:    Jan 8, 2018, 7:39:46 AM
Link:    https://groups.google.com/g/pandoc-announce/c/UY0VvXc1p90
==============================================================================

I'm pleased to announce the release of pandoc 2.1.

Binaries & changelog: https://github.com/jgm/pandoc/releases/tag/2.1
Source & API docs: https://hackage.haskell.org/package/pandoc

This release increments the major version number because
of a few incompatible API changes; however, they are fairly
minor and should not affect most users of the library.

* In Text.Pandoc.Class, the FileTree constructor is no longer exported;
use insertInFileTree and getFileInfo to modify a FileTree.
* In Text.Pandoc.App, the type of applyFilters has changed, and
applyLuaFilters has been removed. The Filter type is also now exported.

This last change gives us a user-facing improvement: JSON
filters and lua filters can now be run in any order. (They
will be run in the order they appear on the command line.)
Previously all lua filters ran before all JSON filters.

A major performance regression in earlier 2.x versions has
been fixed. This caused the pandoc executable to run
much slower at startup.

Albert Krewinkel has continued to improve the lua filters
system, with many improvements that make it easier to write
lua filters.

Jesse Rosenthal has improved the Powerpoint writer and
fixed some issues with the docx reader.

Alexander Krotov has continued to improve the Muse reader
and writer.

Sebastian Talmon has fixed issues with subtitles and
headerless tables in the docx writer.

oltolm has improved formatting of formulas in
the OpenDocument/ODT writer.

Thanks to everyone who contributed with code, discussion, or
bug reports.



==============================================================================
Subject: ANN: pandoc 2.1.1
From:    John MacFarlane
Date:    Jan 18, 2018, 8:07:57 PM
Link:    https://groups.google.com/g/pandoc-announce/c/HODvnCOoH10
==============================================================================

I've just released pandoc 2.1.1:

Binaries/changelog: https://github.com/jgm/pandoc/releases/tag/2.1.1
Source/API docs: https://hackage.haskell.org/package/pandoc

This fixes a few bugs in 2.1, so I recommend that everyone
upgrade. The binary packages also bundle a new version of
pandoc-citeproc, which handles large bibliographies much
more efficiently.

Jesse Rosenthal has greatly improved the powerpoint writer,
which can now accept a --reference-doc template.

Albert Krewinkel has continued to refine the interface for
lua filters, making them easier to write and more powerful.

Thanks also to Alexander Krotov, Robert Schütz, Henri Menke,
and n3fariox for other improvements, and to everyone else
who contributed bug reports or suggestions.



==============================================================================
Subject: ANN: pandoc 2.1.2
From:    John MacFarlane
Date:    Mar 3, 2018, 7:51:26 AM
Link:    https://groups.google.com/g/pandoc-announce/c/MK4HN0n0c_A
==============================================================================

I'm pleased to announce the release of pandoc 2.1.2.

Changelog and binaries:
https://github.com/jgm/pandoc/releases/tag/2.1.2
Source and API docs:
https://hackage.haskell.org/package/pandoc

This release contains a number of incremental improvements
and bug fixes; please see the release notes for details.

There are a few minor API changes: Ext_styles has
been added as a new constructor for Extension, and
a few new functions are exported from Text.Pandoc.Parsers
(manyUntil and the list marker parsers upperRoman,
lowerRoman, decimal, lowerAlpha, upperAlpha). These
should not affect most users.

Thanks to all who contributed!



==============================================================================
Subject: ANN: pandoc 2.1.3
From:    John MacFarlane
Date:    Mar 19, 2018, 2:48:55 AM
Link:    https://groups.google.com/g/pandoc-announce/c/8GrYBVCsrAc
==============================================================================

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

Source & API docs:
https://hackage.haskell.org/package/pandoc
Binary packages & release notes:
https://github.com/jgm/pandoc/releases/tag/2.1.3

The main impetus for this release was to have a version that compiles
with ghc 8.4.1. Semigroup instances have been added for all the Monoid
instances we defined previously. In addition to that, there are a
number of small improvements and bug fixes, which you can find out about
by reading the changelog for this release.

Thanks to Jesse Rosenthal, Alexander Krotov, Marc Schreiber, Mauro Bieg,
Francesco Occhipinti, Nokome Bentley, Henri Menke for code improvements,
John Muccigrosso for documentation improvements, and everyone else who
contributed by reporting bugs or giving useful feedback.



==============================================================================
Subject: ANN: pandoc 2.2
From:    John MacFarlane
Date:    Apr 27, 2018, 9:48:41 PM
Link:    https://groups.google.com/g/pandoc-announce/c/yDvUmof2htg
==============================================================================

I'm happy to announce the release of pandoc 2.2.

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.2
Source & API docs:
https://hackage.haskell.org/package/pandoc

There are lots of bug fixes and small improvements.
Some of the more major changes:

* Pandoc can now read, as well as write, fb2 ebooks
* The --ascii option now works for all XML-based formats
and for groff ms and man, as well as HTML-based formats
* The deprecated options --latexmathml, --gladtex, --mimetex, --jsmath,
-m, --asciimathml have been removed. These are for ancient methods
of rendering math in HTML that have been obsoleted by MathJax
and KaTeX.
* Breaking API change: Removed JsMath, LaTeXMathML, and GladTeX
constructors from Text.Pandoc.Options.HTMLMathMethod.
* We now provide a 64-bit Windows package (as well as 32-bit).

Thanks to all who contributed, including Alexander Krotov,
Joe Hermaszewski, Francesco Occhipinti, Jesse Rosenthal,
Mauro Bieg, Tim Parenti, quasicomputational, Étienne Bersac,
John Muccigrosso, Anabra, teoric, Tristan Stenner, HeirOfNorton.



==============================================================================
Subject: ANN: pandoc 2.2.1
From:    John MacFarlane
Date:    May 11, 2018, 9:08:36 PM
Link:    https://groups.google.com/g/pandoc-announce/c/QPPOoZchnKw
==============================================================================

I'm pleased to announce the release of pandoc 2.2.1:

Changelog and binary packages:
https://github.com/jgm/pandoc/releases/tag/2.2.1
API docs and source code:
https://hackage.haskell.org/package/pandoc

The main reason for the release is that it fixes a regression
introduced in pandoc 2.2. The regression caused bare LaTeX equation
environments in Markdown to be omitted from HTML documents rendered
with --mathjax. If you target HTML with --mathjax, you should definitely
upgrade.

Some other changes of interest:

* The --gladtex option has been restored.
* More robust handling of file:// URIs.
* Fixed regression on PDF output with wkhtmltopdf.
* Improvements in handling of non-ASCII characters in math (due
to texmath-0.11).

See the full changelog for details.

Thanks to everyone who contributed, including Alexander Krotov,
Albert Krewinkel, Mauro Bieg, Francesco Occhipinti, Pablo Rodríguez,
and OvidiusCicero.



==============================================================================
Subject: ANN: pandoc 2.2.2
From:    John MacFarlane
Date:    Jul 16, 2018, 7:05:17 AM
Link:    https://groups.google.com/g/pandoc-announce/c/HCf_upEtW3g
==============================================================================

I'm pleased to announce the release of pandoc 2.2.2:

Changelog and binary packages:
https://github.com/jgm/pandoc/releases/tag/2.2.2
API docs and source code:
https://hackage.haskell.org/package/pandoc

This is mostly a bug-fix release (see changelog for
details). Take note in particular of the following changes:

- We now use a different library to parse YAML
metadata fields. This library implements YAML 1.2,
where the valid boolean "true" values are "true",
"True", "TRUE". Previously, "on", "yes," and "y"
would count as "true" values, but they no longer do.

- --template can now take a URL as argument. In this
case the contents of the template will be fetched
over the network.

Thanks to all who contributed, including Mauro Bieg,
Anders Waldenborg, Raymond Ehlers, Alexander Krotov,
Albert Krewinkel, Adrian Sieber, Gandalf Saxe,
wiefling, kaizshang91, lux-lth, and Felix Yan.



==============================================================================
Subject: ANN: pandoc 2.2.2.1
From:    John MacFarlane
Date:    Jul 20, 2018, 8:01:48 AM
Link:    https://groups.google.com/g/pandoc-announce/c/GFKtUYdWbk4
==============================================================================

On the heels of 2.2.2, I'm releasing pandoc 2.2.2.1,
which fixes a couple of regressions. I advise
everyone who installed 2.2.2 to upgrade.

Changelog and binary packages:
https://github.com/jgm/pandoc/releases/tag/2.2.2.1
API docs and source code:
https://hackage.haskell.org/package/pandoc

One regression prevents pandoc from finding templates
in the user data directory. The other affects parsing
of raw LaTeX in markdown when an `\include` or
`\input` is used.

For a full list of changes, see the changelog.

Thanks to Mauro Bieg and Igor Khorlo for their
contributions, and to everyone who helped report
these problems with version 2.2.2.



==============================================================================
Subject: ANN: pandoc 2.2.3
From:    John MacFarlane
Date:    Aug 6, 2018, 2:07:23 AM
Link:    https://groups.google.com/g/pandoc-announce/c/uJkH8_YtpbI
==============================================================================

I'm pleased to announce the release of pandoc 2.2.3.

Source/API docs:
https://hackage.haskell.org/package/pandoc-2.2.3
Binaries/changelog:
https://github.com/jgm/pandoc/releases/tag/2.2.3

This release fixes a couple small regressions: one
involving numerical keys in YAML metadata, the other
involving linked images in RST.

Text.Pandoc.Lua.Utils now exports `blocks_to_inlines`,
which can be useful in writing filters.

There are various other small improvements. Note that
if you use a custom RST template, you'll want to
change `title` in the template to `titleblock`.

Thanks to everyone who contributed.



==============================================================================
Subject: ANN: pandoc 2.2.3.1
From:    John MacFarlane
Date:    Aug 7, 2018, 7:44:41 AM
Link:    https://groups.google.com/g/pandoc-announce/c/fONuj61yyw8
==============================================================================

I'm pleased to announce the release of pandoc 2.2.3.1:

Source/API docs:
https://hackage.haskell.org/package/pandoc-2.2.3.1
Binaries/changelog:
https://github.com/jgm/pandoc/releases/tag/2.2.3.1

This just fixes a single (serious) regression in
2.2.3, involving parsing of YAML metadata blocks
with complex fields.

I recommend that anyone who installed 2.2.3 upgrade
to this version.



==============================================================================
Subject: ANN: pandoc 2.2.3.2
From:    John MacFarlane
Date:    Aug 7, 2018, 8:16:14 PM
Link:    https://groups.google.com/g/pandoc-announce/c/qaQoL7WGiXo
==============================================================================

I'm pleased to announce the release of pandoc 2.2.3.2:

Source/API docs:
https://hackage.haskell.org/package/pandoc-2.2.3.2
Binaries/changelog:
https://github.com/jgm/pandoc/releases/tag/2.2.3.2

This fixes another YAML metadata regression, involving
Boolean field values.



==============================================================================
Subject: ANN: pandoc 2.3
From:    John MacFarlane
Date:    Sep 17, 2018, 7:50:12 AM
Link:    https://groups.google.com/g/pandoc-announce/c/4QtUN8a_Dy4
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.3
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.3

This release contains many bug fixes and small
improvements, documented in the changelog.

Among the more notable changes is a new command line
option, --metadata-file. This allows users to specify
metadata in a YAML file, regardless of the input format.
(Previously this was only possible for pandoc-flavored
Markdown input.)

Those who use filters that handle raw latex blocks
should be aware that the Markdown reader now parses
TeX-ish content (which generally could be TeX,
LaTeX, or ConTeXt) as raw `tex`. So filters that
looked for raw `latex` blocks may need to be revised
to match on `tex` instead.

Thanks to everyone who contributed!



==============================================================================
Subject: ANN: pandoc 2.3.1
From:    John MacFarlane
Date:    Sep 29, 2018, 5:03:49 AM
Link:    https://groups.google.com/g/pandoc-announce/c/YaRtEABs4Ss
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.3.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.3.1

This release fixes a regression in the RST reader (introduced in
2.1.1), which caused emphasis, links, and other inline containers to
be parsed incorrectly when they extended across line breaks.

It also fixes a persistent problem with the 32-bit Windows
packages, which formerly caused segfaults on Windows 7.

The Markdown reader now puts `uri` and `email` classes on
regular and email autolinks.

In addition, there are many small bug fixes and improvements.

Thanks to Alexander Krotov, Albert Krewinkel, Mauro Bieg,
Francesco Occhipinti, and first-time contributors Ivan Trubach, Jonas
Scholl, Brian Leung, and Nils Carlson.



==============================================================================
Subject: ANN: pandoc 2.4
From:    John MacFarlane
Date:    Nov 4, 2018, 6:26:06 AM
Link:    https://groups.google.com/g/pandoc-announce/c/1rvz6LnSDrM
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.4
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.4

With this release, pandoc now supports roff man as an input
format. Thanks to Yan Pashkovsky, who contributed the initial
man reader.

For a complete list of the many bug fixes and
small improvements in this release, see the changelog:
http://pandoc.org/releases.html#pandoc-2.4-3-november-2018

Thanks to everyone who contributed!



==============================================================================
Subject: ANN: pandoc 2.5
From:    John MacFarlane
Date:    Nov 27, 2018, 6:43:09 PM
Link:    https://groups.google.com/g/pandoc-announce/c/w-yNr_751ZA
==============================================================================

I'm pleased to announce the release of pandoc 2.5,
which is available in the usual places:

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.5
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.5

This version fixes a regression in the parsing of
citations, quotes, and underline emphasis after
symbols (#5099, #5053). I recommend that everyone
upgrade.

There is one API change, which necessitates the major
version number bump: A parameter for Extensions has
been added to uniqueIdent and inlineListToIdentifier
(#5057).

The rest of the changes are bug fixes and minor
improvements, which are documented in the changelog:
http://pandoc.org/releases.html#pandoc-2.5-27-november-2018

Thanks to everyone who contributed!



==============================================================================
Subject: ANN: pandoc 2.6
From:    John MacFarlane
Date:    Jan 31, 2019, 9:01:51 AM
Link:    https://groups.google.com/g/pandoc-announce/c/AL_KpWkO0zE
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.6
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.6

With this release, pandoc now supports Jupyter notebooks
(ipynb) as both an input and an output format.

DokuWiki markup, which was already supported as an output
format, is now supported as an input format as well.

A new `task_lists` extension, enabled by default in
markdown and gfm input, supports markdown "task lists."

There are several API changes:

+ Added Text.Pandoc.Readers.Ipynb
+ Added Text.Pandoc.Writers.Ipynb
+ Added Text.Pandoc.Readers.DokuWiki
+ Added constructor `Ext_task_lists` to `Extension`.
+ Added `taskListItemFromAscii` and `taskListItemToAscii` to
Text.Pandoc.Shared.
+ Text.Pandoc.Readers: Changed types of `readJSON`; it now runs
in an instance of PandocMonad, like the other readers and
writers.
+ Text.Pandoc.Writers: Changed types of `writeJSON`; it now runs
in an instance of PandocMonad, like the other readers and
writers.
+ Text.Pandoc.Error: Added `PandocUTF8DecodingError` constructor
for `PandocError`.
+ Text.Pandoc.Writers.Shared: Added `toTableOfContents`.
+ Text.Pandoc.Parsing: Removed unused `HasHeaderMap`.

For a complete list of the many bug fixes and
small improvements in this release, see the changelog.

Thanks to all who contributed, including Alexander Krotov,
who added the DokuWiki reader, Mauro Bieg, who implemented
task lists, Brian Leung, who improved the RST and Org readers,
Damien Clochard, who fixed bugs in the DokuWiki and VimWiki
writers, Andrew Dunning, who made many improvements to the
default LaTeX template, Albert Krewinkel, who improved
various parts of the code and documentation, Jesse Rosenthal,
who worked on the docx reader and writer, and Agustín Martín
Barber, who improved handling of metadata properties in docx,
pptx, and ODT writers.



==============================================================================
Subject: 
From:    John MacFarlane
Date:    Mar 3, 2019, 9:11:44 PM
Link:    https://groups.google.com/g/pandoc-announce/c/5mOo1z1yXrc
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.7
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.7

Some noteworthy behavior changes:

- We now default to using the XDG data directory
(by default, $HOME/.local/share/pandoc but
overridable by setting XDG_DATA_HOME) instead of
$HOME/.pandoc for the user data directory. If
this directory is not present, $HOME/.pandoc will
be used, for backwards compatibility. On Windows
there are no changes.

- In slide shows, content under headers superordinate
to slide level is no longer omitted; instead, it is
included in the title slide for the section (in HTML
slide formats) or in a slide after the section title
(in beamer). This change facilitates 2D reveal.js
slideshows with content in the top slide on each
stack (#4317, #5237). (Note that you'll still need
to specify --slide-level=2 for this behavior.)

- There is a new command line option
--ipynb-output, with possible values 'all', 'none',
or 'best' (the default). Output cells in ipynb
notebooks often contain several different versions
of an output, with different MIME types, e.g. an
HTML table and a plain-text fallback. Specifying 'best'
ensures that the best version for the output format
is used; 'all' includes all versions; and 'none'
suppresses them all, leaving output cells empty.

- asciidoctor is now an output format separate from
asciidoc, to accommodate some minor
implementation-specific differences (currently just
in the treatment of display math). If you produce
asciidoc that you plan to process using asciidoctor,
use '-t asciidoctor'.

- latexmk can now be used as an option to
--pdf-engine. latexmk has a number of options and
can automatically run bibtex, biber, makeindex, and
other auxiliary programs. Note that you can use
--pdf-engine-opt=-outdir=bar to specify a persistent
temp directory, which should speed up repeated
builds.

API changes:

- Add writeAsciiDoctor to Text.Pandoc.Writers.AsciiDoc.
- Text.Pandoc.Readers.Markdown: add ReaderOptios
parameter to yamlToMeta.
- Text.Pandoc.Shared: remove withTempDir, add
defaultUserDataDirs and filterIpynbOutput.

Thanks to everyone who contributed, including
Mauro Bieg, Jesse Rosenthal, Alexander Krotov,
Albert Krewinkel, Tarik Graba, John KetzerX,
Agustín Martín Barbero, Arfon Smith, and Pascal Wagler.
Thanks also to those who suggested bug fixes and
new features.



==============================================================================
Subject: ANN: pandoc 2.7.1
From:    John MacFarlane
Date:    Mar 14, 2019, 5:40:28 PM
Link:    https://groups.google.com/g/pandoc-announce/c/bw3jJ89KlTw
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.7.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.7.1

The main impetus for this release is to fix a
regression in 2.7, where changes to the default
LaTeX template caused documents with documentclass
'report' to break.

New features of note:

* You can now use --pdf-engine=tectonic (thanks to
Cormac Relf). For more information on tectonic, see
<https://tectonic-typesetting.github.io/en-US/>.

* You can now use -o with --print-default-data-file
(and the other --print-* options), though you must
put the -o option on the command line before
--print-*.

* Ipynb support has been refined, and arbitrary cell
metadata is now supported. Lossless round-tripping
between ipynb and markdown should now be possible.
Note: we recommend disabling the `raw_html` and
`raw_tex` extensions when translating between ipynb
and markdown. This will force the `raw_attribute`
syntax to be used for raw content, and this will
ensure that output cells are constructed properly.

* Pandoc-produced docx files should now work on Word Online.

Thanks to all who contributed, including Andrew
Dunning, Cormac Relf, Paul Tilley, and everyone who
helped diagnose bugs.



==============================================================================
Subject: ANN: pandoc 2.7.2
From:    John MacFarlane
Date:    Apr 6, 2019, 7:14:14 AM
Link:    https://groups.google.com/g/pandoc-announce/c/PAgIzCm0rn8
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.7.2
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.7.2

This release contains many improvements, documented in
the changelog. Of special note:

- A new output format, xwiki, thanks to Derek Chen-Becker.

- The vimwiki reader no longer adds the .html
extension to internal links. If you want the .html
extension to be added, a filter that does this is
given in the changelog.

- Much improved handling of metadata and raw cells in
ipynb, allowing more reliable round-tripping from
ipynb -> markdown -> ipynb.

- The powerpoint writer is now considerably more
robust, thanks to Jesse Rosenthal.

- In the latex template, the subparagraph variable has
been removed. The default is now to use run-in style
for level 4 and 5 headings (\paragraph and
\subparagraph). To get the previous default behavior
(where these were formatted as blocks, like
\subsubsection), set the block-headings variable.

- The Windows binaries are now built using ghc 8.6.4,
which fixes a segfault issue (#5037).

Thanks to everyone who contributed code or bug
reports!



==============================================================================
Subject: ANN: pandoc 2.7.3
From:    John MacFarlane
Date:    Jun 12, 2019, 8:10:43 AM
Link:    https://groups.google.com/g/pandoc-announce/c/0TriHv3YZTU
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.7.3
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.7.3

Some highlights:

- Support for `jira` (Jira wiki) as an output format
(Albert Krewinkel).
- New template variable `curdir` for the directory
in which pandoc is run.n
- Output video and audio elements in HTML, depending on
the file extension of the image path (Mauro Bieg).
- Fixed handling of `file:` URLs (Mauro Bieg).
- Improvements in lua modules (Albert Krewinkel).

API changes:

- New module Text.Pandoc.Writers.Jira, exporting `writeJira`
(Albert Krewinkel).
- Text.Pandoc.MIME: add `mediaCategory` (Mauro Bieg).
- Text.Pandoc.Shared: add `onlySimpleTableCells` (Mauro Bieg).

Many bugs have been fixed, and many small improvements
have been made (see the changelog for a full list).
We recommend that all users upgrade.

Note that some styles that used to be rendered inline
in EPUB have been moved to the default epub templates.
Those who use a custom CSS stylesheet with EPUB should
add these lines to the stylesheet:

code{ white-space: pre-wrap; }
span.smallcaps{ font-variant: small-caps; }
span.underline{ text-decoration: underline; }
q { quotes: "“" "”" "‘" "’"; }
div.column{ display: inline-block; vertical-align: top; width: 50%; }

reveal.js users should update reveal.js to 3.8.0, or
the new default template won't work correctly. Those who
use reveal.js 3.8.0 should also remove the reference to
`head.min.js` from any existing custom reveal.js templates.

Thanks to everyone who contributed!



==============================================================================
Subject: ANN: pandoc 2.8
From:    John MacFarlane
Date:    Nov 23, 2019, 2:27:39 AM
Link:    https://groups.google.com/g/pandoc-announce/c/Tf_1wPJMD0o
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.8
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.8

A full list of changes (including some API changes) can be found at
https://github.com/jgm/pandoc/releases/tag/2.8

Some highlights:

+ Improvements to the template language, adding 'elseif',
'it', partials, filters, and syntax to control nesting
and reflowing of text. These changes make pandoc more
suitable for generating plain text documents (even
tables and enumerated lists) from data in YAML metadata.
For an example, see #37 in https://pandoc.org/demos.html.
Template syntax is now described fully in the manual.

+ A new --defaults flag allows you to specify a collection of
default option values in a YAML file.

+ --list-extensions=FORMAT now lists only extensions affecting FORMAT,
and the use of an unsupported extension raises an error.

+ New option --shift-heading-level, replacing --base-heading-level.
This supports converting documents that use an initial level-1
heading for the document title.

+ --metadata-file can now be used with multiple metadata files.

+ Text is used instead of String throughout the API.

+ The 'unlisted' class may now be used to prevent an unnumbered
heading from appearing in the table of contents.

+ Multiple YAML metadata blocks are now merged differently:
when the same field is given values by two different blocks,
the conflict is resolved in favor of the second (and similarly
with --metadata-file).

+ Note that lua filters that use 'hierarchicalize' will need to
be changed to use 'make_sections' instead, and Haskell filters
and programs using 'hierarchicalize' will need to be rewritten
to use 'makeSections'.

Many bugs have been fixed, and many small improvements
have been made. We recommend that all users upgrade.

Thanks to everyone who contributed! I think we had a record
number of new contributors in this release, including
Arfon Smith, Amogh Rathore, Ben Steinberg, Christian Despres,
Dmitry Pogodin, Eigil Rischel, Félix Baylac-Jacqué, Florian
Beeres, Florian Klink, Jan-Otto Kröpke, Jeroen de Haas, Karl
Pettersson, Krystof Beuermann, Leif Metcalf, Michael Peyton
Jones, Ole Martin Ruud, Owen McGrath, Pete Ryland, Philip Pesca,
Tristan Stenner, Urs Liska, Vanessa McHale, Vasily Alferov,
Zihang Chen, blmage, jeongminkim-islab, niszet, oquechy,
vijayphoenix. Special thanks to Christian Despres for
taking on the big job of moving from String to Text
throughout the code base.



==============================================================================
Subject: ANN: pandoc 2.8.0.1
From:    John MacFarlane
Date:    Nov 27, 2019, 5:53:47 PM
Link:    https://groups.google.com/g/pandoc-announce/c/s_oOfd3KvbI
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.8.0.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.8.0.1

A full list of changes (including some API changes) can be found at
https://github.com/jgm/pandoc/releases/tag/2.8.0.1

This release fixes a couple of regressions in 2.8,
involving the use of --css with EPUB output and the
wrapping of long headings in man pages.

It adds a 'nowrap' template filter that can be used to
prevent values interpolated into template variables from
wrapping.

It also updates skylighting, which should improve some
syntax highlighting issues.

If you've installed 2.8, we recommend upgrading to 2.8.0.1.



==============================================================================
Subject: ANN: pandoc 2.8.1
From:    John MacFarlane
Date:    Dec 6, 2019, 7:16:08 AM
Link:    https://groups.google.com/g/pandoc-announce/c/k1nSrZ3InRs
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.8.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.8.1

A full list of changes (including some API changes) can be found at
https://github.com/jgm/pandoc/releases/tag/2.8.1

This release fixes a couple more regressions from pandoc 2.8:

+ ascii_identifiers extension once again works with markdown
+ --variable specified multiple times with the same variable
once again creates a list
+ --shift-heading-level-by with a positive value no longer
converts the metadata title to a heading
+ Divs with class 'column' starting with a heading should work
again

There are also some other minor improvements, and code signing
has been restored for the Windows msi.



==============================================================================
Subject: ANN: pandoc 2.9
From:    John MacFarlane
Date:    Dec 12, 2019, 7:19:12 AM
Link:    https://groups.google.com/g/pandoc-announce/c/6QHFR62qyVk
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.9
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.9

This is actually a fairly minor release, but it makes
some API changes that require a version bump to 2.9.
The main motivation is to fix some regressions in 2.8:

- A regression whereby attributes on headers would
not be promoted to containing sections when `--section-divs`
was used or a slide show produced.

- A regression with `--toc-depth`.

In addition, a bug in template partial resolution
has been fixed. (This bug allowed files in the working
directory to override default partials when default
templates were used.)

The API changes concern Text.Pandoc.Templates and are
described in the changelog.



==============================================================================
Subject: ANN: pandoc 2.9.1
From:    John MacFarlane
Date:    Dec 23, 2019, 6:02:24 PM
Link:    https://groups.google.com/g/pandoc-announce/c/TeWLRIn33pk
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.9.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.9.1

The main motivation for a release so soon on the
heels of the last one is to fix a bothersome regression,
causing invalid EPUBs to be generated when --number-sections
was used.

But we were also able to sneak in a new Jira reader,
added by Albert Krewinkel.

A number of other minor improvements have been made. Please see
the changelog for details. I recommend that everyone who is on
pandoc 2.8+ upgrade to this version.



==============================================================================
Subject: ANN: pandoc 2.9.1.1
From:    John MacFarlane
Date:    Jan 6, 2020, 6:27:57 AM
Link:    https://groups.google.com/g/pandoc-announce/c/XXMgmXZXq1M
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.9.1.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.9.1.1

This release fixes another regression, involving
slide show structure with manually specified slide level.
It also fixes a few other bugs and changes the DTD
used by the JATS template. See the changelog
for full details.

Thanks to all who contributed!



==============================================================================
Subject: ANN: pandoc 2.9.2
From:    John MacFarlane
Date:    Feb 16, 2020, 4:44:34 PM
Link:    https://groups.google.com/g/pandoc-announce/c/a2ybqyMO2MY
==============================================================================

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.9.2
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.9.2

Some highlights:

* csv is now an input format. You can use pandoc to convert
CSV data into a simple table in any target format pandoc
supports.

* Instead of a single jats output format, we now have
jats_archiving, jats_publishing, and jats_articleauthoring
for different tag sets. The old jats defaults to
jats_archiving.

* It is now much easier to create Lua filters that filter element
lists (e.g., removing spaces before citations).

* 'bibliography' and 'csl' fields may now be used in defaults files.

* Fixed some regressions from 2.7.x, including duplicate class names
and attributes, spurious dots in markdown_mmd metadata output,
columns in beamer slides, tight lists in docx output, and a change in the
behavior of reveal.js when there are more than two levels of nesting.

* Lots of bug fixes and minor improvements.

API changes:

* Added Text.Pandoc.Readers.CSV, exporting readCSV.

* Added new functions writeJatsArchiving, writeJatsPublishing,
and writeJatsArticleAuthoring in Text.Pandoc.Writers.JATS.

* Export html5Attributes, html4Attributes, rdfaAttributes from
Text.Pandoc.XML.

* Add FilterCompleted and RunningFilter constructors to Log
Message in Text.Pandoc.Logging.

Thanks to everyone who contributed, and especially Albert Krewinkel
and new contributors Joseph C. Sible and Ethan Riley.



==============================================================================
Subject: ANN: pandoc 2.9.2.1
From:    John MacFarlane
Date:    Mar 24, 2020, 6:09:20 AM
Link:    https://groups.google.com/g/pandoc-announce/c/bOTzFXgfJYA
==============================================================================

Date: Sun, 16 Feb 2020 07:44:20 -0800

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

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/2.9.2.1
Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.9.2.1

This release fixes a few small bugs and provides a notarized
macOS package that should work with Catalina's Gatekeeper.
See the changelog for details.

Thanks to everyone who contributed!



==============================================================================
Subject: ANN: pandoc 2.10
From:    John MacFarlane
Date:    Jun 30, 2020, 7:22:25 AM
Link:    https://groups.google.com/g/pandoc-announce/c/lm7ZeWOohoo
==============================================================================

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

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

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

Some highlights:

* Pandoc can now be compiled with ghc 8.10.

* A native Underline constructor for Inline (#6277, Vaibhav Sagar)
and more consistent treatment of underlined text in readers
and writers.

* More expressive types for tables (#1024, Christian Despres).
Tables can now take attributes; and rowspans and colspans,
column headers, multiple row headers, table head and foot
can all be represented. (Note, however, that reader and
writer support for these features is still lacking, so
most users won't see any differences in table conversion
yet. These changes just lay the foundation for further
improvements.)

* Templates can now use the pipes `first`, `rest`, `last`, and
`allbutlast` on arrays.

* A new `--no-check-certificate` option to disable certificate
validation when resources are fetched by HTTP (#6156, Cédric Couralet,
Cécile Chemin, Juliette Fourcot).

* Boolean fields now work in metadata within defaults files
(Nikolay Yakimov, #6328).

* The `implicit_figures` extension now works with commonmark
and gfm (#6350).

* We now target version 4.x of reveal.js. File locations have
changed, so if you are using pandoc-produced reveal.js files
with a local copy of reveal.js, you will need to upgrade.

* epub.css has changed to wrap overlong lines in highlighted code
blocks (#6242). This fixes a problem in iBooks v2.4 with our earlier
horizontally scrolling code blocks. The problem seems to
be a bug in iBooks, not pandoc, but since iBooks is a major
target we're changing pandoc's default behavior so that
pandoc-produced epubs work on that platform.

* Many other bug fixes and small improvements (see the changelog
for details).

API changes:

* New Underline constructor for Inline and new Table types for Block.

* Use new type PandocLua for all pandoc Lua operations.

* Use PandocError for exceptions in Lua subsystem.

Thanks to everyone who contributed, and especially Christian Despres for
creating the new table types and modifying the whole code base to use it,
Vaibhav Sagar for implenting the Underline constructor, Mathieu Boespflug for
improving the DocBook reader, Joseph C. Sible for many code improvements and
some important fixes to Text.Pandoc.UUID, and Albert Krewinkel for work on the
lua subsystem, Jira reader and writer, Org reader and writer, and JATS reader.
Thanks, as well, to those who have raised issues, participated in discussions,
and helped to triage bugs.



==============================================================================
Subject: ANN: pandoc 2.10.1
From:    John MacFarlane
Date:    Jul 24, 2020, 7:11:30 AM
Link:    https://groups.google.com/g/pandoc-announce/c/aDKyXI3QFTg
==============================================================================

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

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

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

This release contains a number of noteworthy changes.

We no longer depend on cmark-gfm (which wraps a C library)
for commonmark and gfm parsing and rendering. For parsing
commonmark and gfm, we now use commonmark-hs, my pure
Haskell commonmarking parsing library, which supports many
of the pandoc extensions. For rendering, we rely on the
markdown writer, which when supplied with appropriate
extensions and options generates correct commonmark. If you
notice anything amiss in commonmark or gfm translations,
please report them as there may be some rough edges in this
transition. The upside, however, is that we now support
many more extensions for commonmark and gfm.

`commonmark_x` is now available as a new input and output
format. This is `commonmark` with a number of useful pandoc
extensions enabled. Eventually (when more extensions are
supported) this may become pandoc's default markdown.

There is a new `attributes` extension, which works with
`commonmark` and `gfm`. It allows attributes to be added to
any block or inline element in a uniform way. Since the
Pandoc AST doesn't include attributes on each element type,
the attributes will sometimes be added by creating a
surrounding Div or Span container. To add an attribute to a
block-level element, e.g. a paragraph, put it before the block:

{#mypara}
This is a paragraph.

Multiple attributes may be used and will be combined:

{#mypara}
{.blue .warning key="val"}
1. This is a list.

To add an attribute to an inline-level element, put it
immediately after the element:

*emphasized text*{lang=en}

`--number-sections` now works with docx output (#1413).

amsthm definitions are now supported in the LaTeX reader,
which will be welcome news for mathematicians.

A new `raw_markdown` extension, affecting only ipynb input,
can be used to ensure lossless round-tripping for ipynb
files. It causes markdown cells to be transmitted verbatim,
instead of being parsed by pandoc and then re-rendered,
sometimes with semantically insignificant changes.

For other changes and bug fixes, see the changelog.

Thanks to everyone who contributed, and especially
Laurent P. René de Cotret for adding rowspan and colspan
support for LaTeX tables, Emerson Harkin for adding
`\SIRange` support in LaTeX, Nikolay Yakimov for
improvements to the docx reader and the benchmark
program, Albert Krewinkel for improvements to the org
reader and accessibility improvements to the HTML
writer, and Michael Hoffman for fixing a bug in the ms
writer. Thanks also to those who have raised issues,
participated in discussions, and helped to triage bugs.



==============================================================================
Subject: ANN: pandoc 2.11
From:    John MacFarlane
Date:    Oct 11, 2020, 6:36:25 PM
Link:    https://groups.google.com/g/pandoc-announce/c/1CWkQamP9tM
==============================================================================

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

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

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

The biggest new feature is built-in citation processing (using
the new citeproc library). It is no longer necessary to use
the external filter pandoc-citeproc to process citations (and
we no longer provide pandoc-citeproc in the binary packages).
Instead, just use the --citeproc option where you previously
would have used --filter pandoc-citeproc.

The new citation processing is faster and more accurate than
pandoc-citeproc. In most cases it should serve as a drop-in
replacement, but note the following:

- Whereas pandoc-citeproc searches the `~/.csl` directory for CSL
styles, pandoc searches the `csl` subdirectory of
the pandoc user data directory (e.g., `~/.pandoc/csl` or
`~/.local/share/pandoc/csl`). Users who already keep
CSL styles in `~/.csl` may find it convenient to add a
symlink.

- Copac, EndNote, ISI, MEDLINE, MODS, and RIS bibliographies
are no longer supported. If you use one of these formats,
you may use the `bibutils` utility to convert to BibLaTeX.
We now support only BibTeX, BibLaTeX, CSL JSON,
and pandoc's YAML/Markdown analogue of CSL JSON.

- Using the `--bibliography` option (or including
`bibliography` in YAML metadata) no longer triggers
citation processing implicitly: one must always use the
`--citeproc` option if citation processing is wanted.

- Instead of using pandoc-citeproc with the --bib2json or
--bib2yaml option to convert BibTeX and BibLaTeX bibliographies
to CSL JSON or YAML, one can now use pandoc directly.

In addition to this feature, there are many bug fixes and
small improvements: see the changelog for details.

Thanks to everyone who contributed, and especially to
new pandoc contributors Blake Eryx, Diego Balseiro, Dmitry Volodin,
Leonard Rosenthol, Michael Hoffmann, a-vrma, argent0, and
the-solipsist.



==============================================================================
Subject: ANN: pandoc 2.11.0.1
From:    John MacFarlane
Date:    Oct 14, 2020, 9:05:26 PM
Link:    https://groups.google.com/g/pandoc-announce/c/zcfNvVPMLL8
==============================================================================

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

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

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

This just fixes a few bugs and regressions in the 2.11
release.

In particular,

- There was a problem with the CSLReference environment
definition in the default LaTeX template. This caused
entry spacing information in the style to be ignored,
and it caused an error with lualatex.

- Citation processing for ieee.csl and some other styles
assigned citation numbers in the wrong order (based on
order in the bibliography database rather than order
of first citation).

- Citation collapsing didn't work properly in citatons
beginning with prefixes.

- There was a problem (since 2.10 actually) with the gfm
reader affecting list items containing pipe characters
(#6739).

- There was also a problem with gfm rendering of autolinks,
which were being rendered using raw HTML (#6740).

- The manual had an example that was incorrect.

We also improved support for LaTeX parsing of acronym
commands.



==============================================================================
Subject: ANN: pandoc 2.11.0.2
From:    John MacFarlane
Date:    Oct 16, 2020, 6:08:36 AM
Link:    https://groups.google.com/g/pandoc-announce/c/MeXijgdqB98
==============================================================================

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

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

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

Sorry for another release so close on the heels of the
last one, but there were a couple of regressions in
citation handling that really needed quick fixes.



==============================================================================
Subject: ANN: pandoc 2.11.0.4
From:    John MacFarlane
Date:    Oct 23, 2020, 8:54:48 PM
Link:    https://groups.google.com/g/pandoc-announce/c/YOstnHi2Pts
==============================================================================

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

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

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

This is just a minor release to fix some regressions.

Note: pandoc 2.11.0.3 was released on Hackage but deprecated,
because of some errors. The changelog for the 2.11.0.4
release on the GitHub releases page incorporates the changes
contained in 2.11.0.3.



==============================================================================
Subject: ANN: pandoc 2.11.1
From:    John MacFarlane
Date:    Nov 3, 2020, 11:45:54 PM
Link:    https://groups.google.com/g/pandoc-announce/c/ty2m9JvtMKw
==============================================================================

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

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

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

This is another minor release to fix some regressions (and help
deal with election anxiety).

Minor API change:

Add `PandocBibliographyError` constructor for `PandocError`.
(This will help us give more informative error messages
when pandoc can't parse a bibliography.)

Some other improvements of note:

- Fixed overlong lines in some bibliography styles (e.g., ieee.csl).
- Fixed bug in commonmark with footnote extension, whereby
nested block-level elements inside a footnote would be rendered
in reverse order.
- Fixed regression in JATS output when using `--citeproc`.
- Improved calculation of table column widths in the LaTeX writer.
- Improved treatment of author-in-text citations inside footnotes,
in note styles. Rather than putting the bibliographic data
in paretheses after the author's name, we now separate it using
a comma.
- Fixed improper capitalization of "Ibid." and other labels
generated by `--citeproc`.
- Better handling of inline SVG in HTML.
- Refined default CSS for HTML.
- Added documentation for pandoc's JATS handling.

Thanks to Albert Krewinkel, Mauro Bieg, Nils Carlson, and Andy
Morris for contributions.



==============================================================================
Subject: ANN: pandoc 2.11.1.1
From:    John MacFarlane
Date:    Nov 8, 2020, 5:47:27 AM
Link:    https://groups.google.com/g/pandoc-announce/c/PMiq3iek8KE
==============================================================================

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

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

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

Another minor release to fix some regressions! See the
changelog for the boring details.



==============================================================================
Subject: ANN: pandoc 2.11.2
From:    John MacFarlane
Date:    Nov 20, 2020, 12:02:43 AM
Link:    https://groups.google.com/g/pandoc-announce/c/34CBz8Wv92s
==============================================================================

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

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

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

Changes of note:

* Pandoc now defaults to ATX (## prefixed) headings for Markdown
output. If you want Setext (underlined) headings, you
can specify --markdown-headings=setext. The old --atx-headers
option is deprecated (and doesn't do anything, since ATX
headings are the new default). Thanks to Aner Lucero.

* API change in Text.Pandoc.Logging: Add constructor
ATXHeadingInLHS to LogMessage.

The rest of the changes fix bugs, including a couple of regressions.
(See the changelog for details.) I recommend that everyone upgrade.

Thanks to all who contributed!



==============================================================================
Subject: ANN: pandoc 2.11.3
From:    John MacFarlane
Date:    Dec 18, 2020, 9:12:24 AM
Link:    https://groups.google.com/g/pandoc-announce/c/sO7bULubszQ
==============================================================================

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

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

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

Changes of note:

* `--bibliography` (and `bibliography` in YAML metadata) now searches
the resource path. It can also now take a URL as argument.

* New `sourcepos` extension for commonmark and gfm. When this is
set on the reader, detailed source position information is added
to the AST (and to HTML output).

* Two new extensions affecting the ODT writer: `xrefs_name`
will change internal links to headings, figures, and tables to
opendocument cross-references (using the name of the
referenced item for the description), and `xrefs_number`
will add numbers to these references if available.

* Fixed handling of Boolean metadata values in templates
and in writing YAML metadata.

* Many bug fixes and minor improvements.

Thanks to all who contributed, especially Albert Krewinkel,
Nils Carlson, and new contributors Aner Lucero, Alex Toldaiev,
Igor Pashev, Jan Tojnar, Shin Sang-jae, cholonam, taotieren,
and TEC.



==============================================================================
Subject: ANN: pandoc 2.11.3.1
From:    John MacFarlane
Date:    Dec 19, 2020, 2:49:51 AM
Link:    https://groups.google.com/g/pandoc-announce/c/BO1vkwHdzlw
==============================================================================

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

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

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

This fixes a packaging error in pandoc 2.11.3 (not all of
the files required for testing were included in the release
tarball). Most users should not need to upgrade from 2.11.3.

In addition, we now use citeproc 0.3.0.1, which preserves
nonbreaking spaces at the end of `initialize-with`, allowing
you to use a style that ensures nonbreaking spaces between
initials and surnames.



==============================================================================
Subject: ANN: pandoc 2.11.3.2
From:    John MacFarlane
Date:    Dec 30, 2020, 1:45:06 AM
Link:    https://groups.google.com/g/pandoc-announce/c/WWlu9G6haPo
==============================================================================

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

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

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

This release fixes a couple small regressions in citeproc processing.
Aside from that, the main improvements are these:

- table col/rowspans are now supported by the LaTeX writer (Albert Krewinkel)
- a 'description' field in metadata will now populate an HTML
meta tag (Jerry Sky)
- nested tables are better supported in asciidoc and doxc output
- improved tex math conversion

Thanks to everyone who contributed!



==============================================================================
Subject: ANN: pandoc 2.11.4
From:    John MacFarlane
Date:    Jan 24, 2021, 12:55:59 AM
Link:    https://groups.google.com/g/pandoc-announce/c/xblA1RRnbLI
==============================================================================

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

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

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

As usual, there are a number of bug fixes and small improvements.
The main user-facing changes are:

- biblatex and bibtex now work as output formats as well as
input formats.

- Defaults files can inherit defaults from other defaults files
(using the 'defaults:' field). This allows defaults to be made
modular. (Thanks to David Martschenko.)

- JATS citation output now works again. mixed-citation is used
by default; citations are formatted using the specified CSL style.
When the (new) element_citations extension is enabled,
element-citation is used instead.

- The LaTeX reader now puts contents of unknown environments in a Div
with a class name derived from the environment name, when raw_tex
is not enabled. This allows filters to do something with the environment.

API changes:

- New Text.Pandoc.Writers.BibTeX module, exporting writeBibTeX
and writeBibLaTeX.

- New Ext_element_citations constructor for Extension.

- Text.Pandoc.Citeproc exports getStyle and getReferences.

Thanks to all who contributed and especially to new
contributors David Martschenko and Dimitri Sabadie.



==============================================================================
Subject: ANN: pandoc 2.12
From:    John MacFarlane
Date:    Mar 8, 2021, 10:01:07 PM
Link:    https://groups.google.com/g/pandoc-announce/c/13V1r24jXfY
==============================================================================

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

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

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

In addition to the usual bug fixes and minor improvements, there
are a number of notable user-facing changes in this release.

The `--resource-path` option can now be specified multiple times,
and the resource path components will accumulate. Resource paths
specified later on the command line are prepended to those specified
earlier. `resource-path` in defaults files behaves the same way: it
will be prepended to the resource path set by earlier command line options
or defaults files. This change facilitates the use of multiple defaults
files: each can specify a directory containing resources it refers to
without clobbering the resource paths set by the others.

In defaults files, there is now a way to refer to the home directory, the
user data directory, and the directory containing the defaults file
itself. In fields that expect file paths (and only in these fields),

+ `${VARIABLE}` will expand to the value of the environment variable
`VARIABLE` (and in particular `${HOME}` will expand to the path
of the home directory). A warning will be raised for undefined
variables.
+ `${USERDATA}` will expand to the path of the user data
directory in force when the defaults file is being processed.
+ `${.}` will expand to the directory containing the defaults file.
(This allows default files to be placed in a directory containing
resources they make use of.)

When downloading content from URL arguments, pandoc is now sensitive to
the character encoding (#5600). We can properly handle UTF-8 and latin1
(ISO-8859-1); for others we raise an error. We fall back to latin1 if
no charset is given in the mime type and UTF-8 decoding fails.

With `--abbreviations`, a period is no longer required at the end
of an abbreviation (so, e.g. `M` can be put in an abbreviation
file for French).

The `task_lists` extension now works for org input.

We have replaced xml-light with xml-conduit for all the XML
format readers. (This required some patches upstream.)
The change was required by some XML that xml-light could not
handle, but a tangible side benefit is a very significant speed
bump. xml-conduit is now also used in skylighting, which speeds
up parsing of syntax definitions by about 4X.

In addition to the XML based readers, we have improved performance
in the HTML, LaTeX, and Markdown readers. Here are some benchmarks
comparing the previous version to this one:

Conversion pandoc 2.11.4 pandoc 2.12
------------------ ------------------- ----------------------
-f docbook 18 ms (35MB alloc) 6 ms (20 MB alloc)
-f docx 72 ms (105 MB) 42 ms (98 MB)
-f epub 64 ms (161 MB) 35 ms (80 MB)
-f fb2 14 ms (26 MB) 4 ms (13 MB)
-f html 34 ms (95 MB) 24 ms (53 MB)
-f latex 29 ms (147 MB) 16 ms (54 MB)
-f odt 78 ms (110 MB) 27 ms (66 MB)
-f org 54 ms (183 MB) 44 ms (137 MB)

So many more milliseconds to enjoy life!

We now provide arm64 binaries for linux. In addition, we have
started using an option in creating linux binaries that makes
them 30% smaller.

This release has a major version bump because of a number
of (mostly minor) API changes:

* Text.Pandoc.Readers.HTML:
+ Remove exported class `NamedTag(..)`.
+ The functions `isInlineTag` and `isBlockTag` are no longer polymorphic;
they apply to a `Tag Text`.
* Text.Pandoc.Readers.LaTeX:
+ `tokenize` and `untokenize` are no longer exported.
* Text.Pandoc.Readers.LaTeX.Types is no longer exported.
* Text.Pandoc.Shared:
+ Remove formerly exported functions that are no longer used in the
code base: `splitByIndices`, `splitStringByIndicies`, `substitute`,
and `underlineSpan`.
+ Export `handleTaskListItem`.
+ Change `defaultUserDataDirs` to `defaultUserDataDir` which returns
a single directory.
* Text.Pandoc.MIME:
+ Export `getCharset`.
* Text.Pandoc.UTF8:
+ Change IO functions to return Text, not String. This affects
`readFile`, `getContents`, `writeFileWith`, `writeFile`, `putStrWith`,
`putStr`, `putStrLnWith`, `putStrLn`. `hPutStrWith`, `hPutStr`,
`hPutStrLnWith`, `hPutStrLn`, `hGetContents`.
* Text.Pandoc.App
+ Export `parseOptionsFromArgs`.
+ Add fields for CSL options to `Opt`:
`optCSL`, `optbibliography`, `optCitationAbbreviations`.
* Text.Pandoc.Class
+ Export `getTimestamp`.
* Text.Pandoc.Error
+ Add `PandocUnsupportedCharsetError` constructor for `PandocError`.
+ Export `renderError`.

Thanks to all who contributed, especially Albert Krewinkel and
new contributors Loïc Grobol, Lorenzo, Nick Berendsen,
and Nixon Enraght-Moony. Olivier Benz deserves credit for helping
make the arm64 binaries possible by providing a Docker image
with recent ghc compiled for arm64.



==============================================================================
Subject: ANN: pandoc 2.13
From:    John MacFarlane
Date:    Mar 21, 2021, 6:10:08 AM
Link:    https://groups.google.com/g/pandoc-announce/c/fBDU83U9-Sk
==============================================================================

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

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

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

This is a major version bump because we took the opportunity
to clean up some cruft in the API. But the API changes are minor
and should not affect must users of the library.

API changes:

* Text.Pandoc.Shared: remove backslashEscapes and escapeStringUsing.
* Text.Pandoc.Shared: remove ToString and ToText typeclasses, which were
used when we were making the transition from Stirng to Text.
* Text.Pandoc.Parsing: change the type of readWithM, so that it
always expects Text input instead of being polymorphic.
* Text.Pandoc.Parsing: remove the F type synonym.
* Text.Pandoc.Readers.Metadata: eport yamlMetaBlock.
* Text.Pandoc.Readers.Metadata: make yamlBsToMeta and yamlBsToRefs
polymorphic on teh parser state.
* Text.Pandoc.Logging: add DuplicateAttribute contsructor for LogMessage.

Some highlights of the user-facing changes:

- yaml_metadata_block extension now works for commonmark (though in a more
limited way than with markdown).
- template partials are sought in the default templates if they
aren't supplied with a custom template.
- nocite works better now with --biblatex and --natbib options.
- the tex_math_backslash extension works again.
- Haskell syntax highlighting works again.

Thanks to everyone who contributed, especially Albert Krewinkel and
new contributors Bodigrim, Erik Rask, and Florian Kohrt.



==============================================================================
Subject: ANN: pandoc 2.14
From:    John MacFarlane
Date:    May 29, 2021, 8:00:28 AM
Link:    https://groups.google.com/g/pandoc-announce/c/Hqb_VHp98rE
==============================================================================

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

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

Source & API documentation:
http://hackage.haskell.org/package/pandoc-2.14 [*]

[*] As I write this, Friday evening May 28, Hackage is down for
service, so I haven't been able to upload the package
yet. But when I do, it will be available at the link above.

Some highlights of the user-facing changes:

* Pandoc's text-format parsers are now aware of the file from which
each part of the source comes. That means better error messages,
more accurate source positions, and the possibility of resolving
relative paths (for includes and images) relative to the file
containing them, rather than the working directory. (See below on
the rebase_relative_paths extension.

* New extension rebase_relative_paths, which can optionally be
enabled for markdown and commonmark readers (including gfm). When
enabled, this extension rewrites relative image and link paths by
prepending the (relative) directory of the containing file. This
behavior is useful when your input sources are split into multiple
files, across several directories, with files referring to images
stored in the same directory. This closes a longstanding issue
(#3752).

* Curly-brace syntax for Markdown citation keys, allowing the use
of citation keys that are not otherwise recognizable by pandoc
due to their use of special characters. Using URLs as citation
keys now becomes feasible (#6026).

* Paths of include files in RST and Org are now properly resolved
relative to the containing file (#5501, #6632).

* The docx reader and writer now supports many new table features,
thanks to Emily Bourke (#6316) and Albert Krewinkel (#6315):
column spans, row spans, multiple header rows, table description
(parsed as a simple caption), captions, column widths.

* The LaTeX reader now has much improved support for siunitx commands,
and for \xspace and \newif.

* The HTML reader now parses <h1> elements as normal headers, even
if they have the class `title`. (Previously these were dropped,
on the assumption that they were recapitulating the metadata
title.) Use --shift-heading-level-by=-1 to turn the <h1> into the
document title, or a filter to restore the previous behavior.

* In beamer output, blocks with the classes 'example' and 'alert'
are now rendered as special exampleblock and alertblock
environments.

This is a major version bump because of some API changes:

* New exported module, Text.Pandoc.Sources. This defines a
type, Sources, that represents a number of chunks of
text labeled with source positions, and a typeclass, ToSources,
whose instances can be converted to Sources. The module also
exports modified versions of parsec Char parsers which take
a Sources as the stream type and automatically update source
positions as it moves through the labeled chunks.

* All of the readers that formerly took a Text parameter are now
polymorphic and can accept any instance of the (new) ToSources
typeclass. Text is an instance, so most current uses of the
readers should work without modification.

* Text.Pandoc.Parsing:
+ All parsers defined on Text as a stream are now defined on Sources.
+ The module also exports all of the modified Char parsers defined in
Text.Pandoc.Sources.
+ The old insertIncludedFileF has been removed, and insertIncludedFile
has been given a more general type, allowing it to be used where
insertIncludedFileF was.
+ The citeKey parser has been given a new parameter, which controls
whether the @{..} syntax is allowed.

* Text.Pandoc.Error: Modified the constructor PandocParsecError to take
a Sources rather than a Text as first argument, so parse error locations
can be accurately reported.

* Text.Pandoc.Extensions: Add constructor Ext_rebase_relative_paths to
Extensions.

* Text.Pandoc.XML.Light: add Eq, Ord instances for Content, Element,
Attr, CDataKind.

* Text.Pandoc.MediaBag:

+ Change MediaBag to use a Text key instead of [FilePath].
+ Export MediaItem type.
+ Change MediaBag type to a map from Text to MediaItem.
+ lookupMedia now returns a MediaItem.

* Text.Pandoc.Class: Remove fetchMediaResource.

* Text.Pandoc.Logging: Add LoadedResource constructor to LogMessage.

* Text.Pandoc.Asciify: export toAsciiText.

* Text.Pandoc.Highlighting: Change type of languagesByExtension,
adding a parameter for a SyntaxMap.

* Remove Text.Pandoc.BCP47 module. Use types and functions from
UnicodeCollation.Lang instead.

In addition, there are many bug fixes and small changes. For
details, see the changelog.

Thanks to everyone who contributed, especially Albert Krewinkel and
new contributors Anti-Distinctlyminty, Charanjit Singh, Emily
Bourke, Julien Dutant, Roman Beránek, Tatiana Porras, badumont,
mbrackeantidot, nuew, obcat, and tecosaur.

John MacFarlane
unread,
May 29, 2021, 6:05:53 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com

> Source & API documentation:
> http://hackage.haskell.org/package/pandoc-2.14 [*]
>
> [*] As I write this, Friday evening May 28, Hackage is down for
> service, so I haven't been able to upload the package
> yet. But when I do, it will be available at the link above.

I'm not sure whether Hackage is actually down. They were
planning to take it down last night, but according to the
status page it is operational.

When I attempt to upload, I get a 413 Request Entity Too Large
error.

Reported here:
https://github.com/haskell/hackage-server/issues/935

Does anyone know anything that might help?

John MacFarlane
unread,
May 29, 2021, 9:47:59 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com

Problem solved. I had to put the tarball on a diet.



John MacFarlane <j...@berkeley.edu> writes:

>> Source & API documentation:
>> http://hackage.haskell.org/package/pandoc-2.14 [*]
>>
>> [*] As I write this, Friday evening May 28, Hackage is down for
>> service, so I haven't been able to upload the package
>> yet. But when I do, it will be available at the link above.
>
> I'm not sure whether Hackage is actually down. They were
> planning to take it down last night, but according to the
> status page it is operational.
>
> When I attempt to upload, I get a 413 Request Entity Too Large
> error.
>
> Reported here:
> https://github.com/haskell/hackage-server/issues/935
>
> Does anyone know anything that might help?



==============================================================================
Subject: ANN: pandoc 2.14.0.1
From:    John MacFarlane
Date:    Jun 1, 2021, 3:30:25 PM
Link:    https://groups.google.com/g/pandoc-announce/c/Hm755m3wNYw
==============================================================================

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

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

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

This release fixes a few serious regressions in 2.14.
Everyone who has installed 2.14 should upgrade.
For details, see the changelog.



==============================================================================
Subject: ANN: pandoc 2.14.0.2
From:    John MacFarlane
Date:    Jun 13, 2021, 8:04:47 PM
Link:    https://groups.google.com/g/pandoc-announce/c/I0nu4rvnWx0
==============================================================================

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

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

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

This release fixes a few more regressions in 2.14, involving
`--citeproc`, `--extract-media`, SVGs in PDF output, and tables
with empty headers. Everyone who has installed 2.14 or 2.14.0.1
should upgrade. For full details, see the changelog.

Note 1: although it is now possible to compile pandoc for Apple Silicon
(M1), we do not yet have the infrastructure to provide a universal binary,
so our packages just contain an Intel build. For now, users on M1 macs
can use homebrew to install a native version of pandoc.

Note 2: linux arm packages aren't uploaded yet -- I'll upload them
later today after they're built.



==============================================================================
Subject: ANN: pandoc 2.14.0.3
From:    John MacFarlane
Date:    Jun 23, 2021, 12:02:33 AM
Link:    https://groups.google.com/g/pandoc-announce/c/ZEhYYDlFRW8
==============================================================================

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

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

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

This release fixes a few more regressions, involving media paths,
comment-only YAML metadata blocks, and LaTeX tables. A few
non-regression bugs have also been fixed, and the latest versions of
skylighting and commonmark are now used. full details, see the changelog.

I recommend that anyone who has installed an earlier version
in the 2.14.x series upgrade to this one.



==============================================================================
Subject: ANN: pandoc 2.14.1
From:    John MacFarlane
Date:    Jul 19, 2021, 7:43:30 AM
Link:    https://groups.google.com/g/pandoc-announce/c/yWQpJxKTYoQ
==============================================================================

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

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

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

This release fixes some bugs and makes a number of minor improvements.
Nothing really stands out, so I'll just say: check the changelog
for details.

There is one minor API change: the addition of a Tiff constructor
to ImageType.

Thanks to all who contributed, including Jan Tojnar, Aner Lucero,
Michael Hoffmann, and Mauro Bieg.



==============================================================================
Subject: ANN: pandoc 2.14.2
From:    John MacFarlane
Date:    Aug 21, 2021, 6:57:36 PM
Link:    https://groups.google.com/g/pandoc-announce/c/Z6asQ-BhglY
==============================================================================

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

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

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

In addition to a bunch of under-the-hood improvements
and bug fixes, there are some new features:

* pandoc now supports RTF as an input format (RTF output has
been supported for a long time)

* --slide-level can now be set to 0. In this case headings won't
be used at all in splitting the document into slides: all slide
boundaries must be marked with horizontal rules.

* A new markdown extension short_supsuperscripts has been added; it
modifies the behavior of subscript and superscript, allowing
them to end with a space character as in multimarkdown. This
improves support for multimarkdown.

* The docx writer is now sensitive to the native_numbering extension
(in the same way as the ODT writer). Figure and table numbers are
only included if native_numbering is enabled (the default is
disabled). This is a behavior change with respect to 2.14.1, but the
default behavior is now that of previous versions. The
change was necessary to avoid incompatibilities between
pandoc's native numbering and third-party cross reference
filters like pandoc-crossref.

* --citeproc now hyperlinks the title of a bibliography entry
(or the whole entry, if no title is present) if the bibliographic
data contains a DOI, PMID, PMCID, or URL but this is not explicitly
rendered by the style. Rendered DOI, PMID, PMCID, and URL
fields are hyperlinked as they were before. This follows a
recomendation from the draft CSL v1.0.2 spec (Appendix VI). You
can disable all hyperlinking in the bibliography by setting
`link-bibliography: false` in the metadata.

API changes:

* New module Text.Pandoc.Readers.RTF, exporting readRTF.
* Text.Pandoc.Logging: Add PowerpointTemplateWarning constructor
to LogMessage.
* Text.Pandoc.Extension: add Ext_short_subsuperscripts constructor
to Extension.

See the changelog for full details.

Thanks to Emily Bourke and new contributors Benjamin Bray, OCzarnecki,
Peter Fabinksi, Veratyr, William Lupton, and mt_caret.



==============================================================================
Subject: ANN: pandoc 2.15
From:    John MacFarlane
Date:    Oct 24, 2021, 4:59:30 AM
Link:    https://groups.google.com/g/pandoc-announce/c/o5NR1-s-roY
==============================================================================

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

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

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

For a full description of the changes, see the changelog. But
here are a few of the more prominent changes:

* A new option --sandbox will ensure that pandoc's readers and writers do
no IO besides reading from the files specified on the command line and
writing the output. This restriction is enforced by the type system.
Anyone who uses pandoc to process untrusted data should use this
option (keeping in mind especially that some formats, such as RST,
Org, and LaTeX, have directives for including files). Note: filters, PDF
production, and custom writers are unaffected. If you use these features,
you are responsible for considering the security risks. Those who
maintain libraries (such as pypandoc) that run pandoc with a system
call may want to consider adding --sandbox to the parameters used by
default.

* Pandoc will now fall back to latin1 encoding for inputs that can’t be read as
UTF-8. This is what it did previously for content fetched from the web and not
marked as to content type. It makes sense to do the same for local files. In
this case a NotUTF8Encoded warning will be issued, indicating that pandoc is
interpreting the input as latin1.

* SVG images can now be used with docx output.

* Support for Powerpoint output is much improved (thanks to the work of
Emily Bourke). See the changelog for full details.

* The LaTeX writer now uses babel exclusively for multilingual support.
(We used to use polyglossia with xelatex.) If you use a custom template,
you will probably need to update it to take account of these changes.

* The --reference-location option now works with HTML output (thanks
to Francesco Mazzoli).

* Native output is now formatted using pretty-show, which gives nicer
results for tests and debugging (which is the main purpose of
native output).

* gfm now supports footnotes.

* Better performance and error messages in Lua filters, due to Albert Krewinkel.

* Code changes have been introduced (by Aner Lucero) which will streamline
the addition of a real Figure block element in a future release.

API changes:

* Text.Pandoc.Logging: add NotUTF8Encoded constructor to LogMessage.

* Text.Pandoc.Class: Add readStdinStrict method to PandocMonad.

* Text.Pandoc.Class: Generalize type of extractMedia. It was uselessly
restricted to PandocIO, instead of any instance of PandocMonad and MonadIO.

* Text.Pandoc.Shared: export splitSentences.

* Text.Pandoc.Class.PandocIO: derive MonadCatch, MonadThrow, MonadMask.

* Add module Text.Pandoc.Class.Sandbox, exporting sandbox via Text.Pandoc.Class.

* Text.Pandoc.Filter: Generalize type of applyFilters from PandocIO to
any instance of MonadIO and PandocMonad.

* Text.Pandoc.PDF: Generalize type of makePDF: instead of PandocIO, it
can be used in any instance of PandocMonad, MonadIO, and MonadMask.

* Lua subsystem and custom writers: generalize types from PandocIO to
any instance of PandocMonad and MonadIO [API change]. The type of runLua
is now
`(PandocMonad m, MonadIO m) => LuaE PandocError a -> m (Either PandocError a)`.

Thanks to everyone who contributed, including new contributors Christophe
Dervieux, Ezwal, Francesco Mazzoli, Milan Bracke, Quinn, Samuel Tardieu,
Simon Schuster, and hseg; and stalwarts Albert Krewinkel, Aner Lucero,
Emily Bourke, Jeroen de Haas, Salim B, William Lupton, and nuew.



==============================================================================
Subject: ANN: pandoc 2.16
From:    John MacFarlane
Date:    Oct 31, 2021, 10:11:06 PM
Link:    https://groups.google.com/g/pandoc-announce/c/CqtX4--wji0
==============================================================================

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

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

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

The reason for a release so soon on the heels of 2.15 is
to fix some regressions in Lua filter support that came
with the transition to hslua 2. Anyone using Lua filters
is advised to upgrade immediately.

The other major change is a switch from the HsYAML library
back to the yaml library for parsing YAML metadata. This
change makes YAML parsing 20X faster, so that it
should once again be possible to use large bibliographies in
YAML format. For the most part this change should be
invisible to users, but note the following:

- Unlike HsYAML, yaml parses 'Y', 'N', 'Yes', 'No', 'On',
and 'Off' as boolean values. Users may need to quote
these when they are meant to be interpreted as strings.
Similarly, 'null' is parsed as a YAML null value (and
will be treated as an empty string by pandoc rather than
the string 'null'). Quoting it will force it to be
interpreted as a string.

- Pandoc should now fail with an informative error when
you don't escape your YAML properly, instead of failing
silently and parsing the section as regular text.

The API changes: yaml has no separate FromYAML typeclass,
just using FromJSON instead, so all the FromYAML instances
for pandoc types have been dropped. In addition, the
JSON encodings of a few types have been changed (LineEnding,
HTMLSlideVariant, ReaderOptions, Extension, Extensions,
Opt). (These changes shouldn't affect JSON filters, because
they don't concern the types defined in pandoc-types.)

Thanks to all who contributed, especially Albert Krewinkel
for his work on the Lua subsystem and Tristan Stenner for
some improvements to the docx writer.



==============================================================================
Subject: ANN: pandoc 2.16.1
From:    John MacFarlane
Date:    Nov 3, 2021, 8:27:06 AM
Link:    https://groups.google.com/g/pandoc-announce/c/X83Wxd4Bt_w
==============================================================================

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

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

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

This release fixes a few regressions in 2.15 and 2.16,
affecting the docx reader and the Lua subsystem.
Upgrades are recommended for everyone who has
installed pandoc 2.15 or 2.16.



==============================================================================
Subject: ANN: pandoc 2.16.2
From:    John MacFarlane
Date:    Nov 22, 2021, 2:34:48 AM
Link:    https://groups.google.com/g/pandoc-announce/c/oxT1L_Ymcxg
==============================================================================

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

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

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

This release adds an exciting new feature: it is now possible
to create custom readers (parsers) in Lua, to support formats
not currently understood by pandoc. Custom writers were already
possible, as were custom AST transformations (filters). So now
every step in the conversion process can be customized using Lua.

To facilitate custom readers (and for use in filters), we
now compile lpeg into the Lua subsystem. lpeg is a library
allowing easy construction of parsers using a PEG grammar.
Filters and custom readers can use lpeg without assuming
that the users have it installed locally.

For more on custom readers, see the documentation at
<https://pandoc.org/custom-readers.html>.
This includes three examples, including a RIS bibliography
parser and a parser for WikiCreole syntax (only 190 lines
of Lua, and it performs better than the built-in creole reader).

In addition to this major feature, this release contains a
number of smaller bug fixes and minor improvements.

API change:

- New module Text.Pandoc.Readers.Custom, exporting readCustom.

Thanks to everyone who contributed, including Albert Krewinkel,
Aner Lucero, Christophe Dervieux, and new contributors
Christian Despres, Rowan Rodrik van der Molen, Fabián Heredia Montiel,
S.P.H, and willj-dev.



==============================================================================
Subject: ANN: pandoc 2.17
From:    John MacFarlane
Date:    Jan 13, 2022, 5:32:16 AM
Link:    https://groups.google.com/g/pandoc-announce/c/SL7IW7lfhw0
==============================================================================

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

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

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

In addition to the usual under-the-hood improvements
and bug fixes, there are some new features:

* `markua` (a Markdown variant used by Leanpub) is now supported as an
output format.
* `--wrap=auto` will now wrap HTML output.
* Custom (Lua) readers can now access the full list of sources,
not just the concatenated text.
* Official Org-cite citations are now supported in Org mode.
* Counter cookies and (with the fancy_lists extension)
alphabetical lists are supported in Org mode.
* Custom (Lua) writers can now set template variables and access
pandoc writer options.
* `r-stretch` classes can be attached to images in reveal.js, and
`r-fit-text` classes can be attached to headers.
* HTML and EPUB templates now support abstracts.
* Powerpoint now uses a 16:9 aspect ratio by default.
* The Lua subsystem has many improvements, giving filters
writers much more power (top down traversals, control
over pandoc writers, access to bibliographic, and more:
see changelog for details.)

API changes:

* Export writeMarkua from Text.Pandoc.Writers.Markdown.
* Do not export writeCustom from Text.Pandoc.Writers.
* Text.Pandoc.Filter.applyFilters now takes a filter environment
of type Environment, instead of a ReaderOptions value.
* Text.Pandoc.Filter exports the Environment type.
* Global in Text.Pandoc.Lua has a new constructor PANDOC_WRITER_OPTIONS.

See the changelog for full details.

Thanks to all who contributed, including Albert Krewinkel,Jörn
Krenzer, Kolen Cheung, Martin Fischer, Mauro Bieg, Michael
Hoffmann, and new contributors Jannik Buhr, Jesse Hathaway,
Lucas Viana, Tuong Nguyen Manh, Tim Wisotzki and Saumel
Lemmenmeier.



==============================================================================
Subject: ANN: pandoc 2.17.0.1
From:    John MacFarlane
Date:    Jan 14, 2022, 9:08:49 PM
Link:    https://groups.google.com/g/pandoc-announce/c/FsstC506bpY
==============================================================================

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

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

Source & API documentation:
https://hackage.haskell.org/package/pandoc-2.17.0.1

This release fixes a few regressions in 2.17.
I recommend that everyone upgrade.



==============================================================================
Subject: ANN: pandoc 2.17.1
From:    John MacFarlane
Date:    Jan 30, 2022, 9:58:02 PM
Link:    https://groups.google.com/g/pandoc-announce/c/HSi03adkMG0
==============================================================================

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

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

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

This release brings a number of bug fixes and small improvements.
Of special note:

* pagedjs-cli may now be used as a --pdf-engine
* Text.Pandoc.Class now exports readMetadataFile [API change]
* Text.Pnadoc.Error now exports the PandocColudNotFindMetadataFileError
constructor for PandocError [API change]

Thanks to all who contributed, including Albert Krewinkel (who
made extensive improvements to the Lua subsystem), Michael Hoffmann,
Nikolai Korobeinikov, ricnorr, Even Brenden, Mauro Bieg, Benson Muite,
and Carsten Allefeld.



==============================================================================
Subject: ANN: pandoc 2.17.1.1
From:    John MacFarlane
Date:    Jan 31, 2022, 8:21:12 PM
Link:    https://groups.google.com/g/pandoc-announce/c/XOf9oQdxTc8
==============================================================================

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

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

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

Mainly this release just fixes a bad regression in 2.17.1,
which broke the expected behavior of `--defaults` (defaults
files were no longer found in the default user data directory).



==============================================================================
Subject: ANN: pandoc 2.18
From:    John MacFarlane
Date:    Apr 4, 2022, 8:36:18 PM
Link:    https://groups.google.com/g/pandoc-announce/c/71MwcshMpko
==============================================================================

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

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

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

In addition to the usual under-the-hood improvements
and bug fixes, there are some new features:

* New input formats: endnotexml and ris bibliographies.

* A RIS bibliography file may now be used with `--citeproc`.

* Citeproc now allows a formatted bibliography to be placed
in a metadata field (and thus to be placed at an arbitrary
position in a template). To do this, include a metadata
field (say, 'refs') whose content is an empty Div with id 'refs'.

* Metadata files specified with --metadata-file are now sought
in $DATADIR/metadata if not found locally.

* --self-contained now issues a warning rather than failing with
an error when a resource cannot be found.

* The LaTeX reader will now skip parts of local packages imported with
\usepackage that it cannot parse.

* The Lua interface adds a new module pandoc.layout, allows any
type of callable object as an argument to list functions
filter, map, and find_if, and allows passing a Sources object
to pandoc.read.

* wkhtmltopdf is again the default PDF engine for HTML.

* LaTeX and JATS templates have been revised, so take note if you
use custom templates.

* A new compiler flag lua53 (false by default) will cause pandoc
to be built with embedded Lua 5.3. By default Lua 5.4 will be
embedded. pandoc --version will now tell you which version of
Lua is embedded.

API changes:

* New exported module Text.Pandoc.Readers.RIS (readRIS).

* New exported module Text.Pandoc.Readers.EndNote (readEndNoteXML,
readEndNoteXMLCitation).

* Text.Pandoc.Logging: Add CouldNotParseIncludeFile constructor for
LogMessage.

* Text.Pandoc.Error: Export PandocCouldNotFindMetadataFileError
constructor for PandocError.

* Text.Pandoc.Parsing: Change type of tableWith' and gridTableWith'
so they return a structured TableComponents rather than a tuple.
Export tableWith', TableComponents, TableNormalization,
toTableComponents, toTableComponents'.

* Text.Pandoc.XML.Light: Export parseXMLElementWithEntities,
parseXMLContentsWithEntities (these allow specifying a custom entity map).

* Text.Pandoc.Class: Export readMetadataFile.

Thanks to everyone who contributed, especially new contributers
Dmitris Apostolou, Guriy Samarin, Ivar de Bruin, Jaap de Jong,
Jonathan Dönszelmann, Lucas V. R, Mario Lang, Naveen, Ola Wolska,
damon-sava-stanley, mjfs.

John MacFarlane
unread,
Apr 6, 2022, 10:48:29 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com

I forgot to mention a major feature that was added: if you
add the `citations` extension to `docx` (`-f docx+citations`),
pandoc can now extract embedded Zotero, Mendeley, and EndNote
citations and treat them as native pandoc citations (so that
you can use `--citeproc` with them). If the `citations`
extension is not used, then the text generated by the citation
plugin is just translated as usual.



==============================================================================
Subject: ANN: pandoc 2.19
From:    John MacFarlane
Date:    Aug 4, 2022, 9:01:39 AM
Link:    https://groups.google.com/g/pandoc-announce/c/qoBPwxvofro
==============================================================================

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

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

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

Some notable changes:

* New --embed-resources flag, which does not imply --standalone.
--self-contained is now deprecated in favor of --embed-resources --standalone.

* Custom Lua readers and writers are now sought in the readers and writers
subdirectories of the user data directory, if not found in the working
directory.

* New input format 'tsv' (tab-separated values).

* RST, Org-mode, and Markdown readers now support row and colspans
in grid tables. (The corresponding writers do not yet support
these features.)

* EPUBv3, which previously always used MathML to render math, now
allows a choice of math methods, just like EPUBv2. (If you've
been relying on the default of producing MathML and want that
to continue, you should now add --mathml to your command line.)

* Environment variable interpolation now works in highlight-style
and pdf-engine fields in defaults files.

API changes:

* Text.Pandoc.Readers.CSV now exports `readTSV`.

* Text.Pandoc.Class: add new function findFileWithDataFallback.

* Text.Pandoc.Shared: add new function formatCode.

* Text.Pandoc.Parsing: Remove boolean parameter from gridTableWith' and
gridTableWith. We now always handle a table head if present.

For a full accounting of the many changes and bug fixes in this
release, see the changelog.

Thanks to all who contributed, including Albert Krewinkel, Brian
Leung, Frerich Raabe, John Muccigrosso, Naveen, and new
contributors Amir Dekel, Bastien Dumont, Benjamin Wuethrich,
Castedo Ellerman, Cezary Drożak, Elliot Bobrow, Gabriel
Lewertowski, Georgi Lyubenov, Hos Es, Ivan Panchenko, Jaehwang
Jung, Masataka Ogawa, Sukil Etxenike, Sukka, Wentao Han, YI, and
black-desk,



==============================================================================
Subject: ANN: pandoc 2.19.1
From:    John MacFarlane
Date:    Aug 19, 2022, 9:00:24 AM
Link:    https://groups.google.com/g/pandoc-announce/c/6nD3cVhym2k
==============================================================================

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

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

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

The main impetus for this release was to fix a regression
introduced in 2.19 involving link coloring on PDF output.

In addition, there is one major new feature: pandoc can now
be used as a web server or CGI program, when renamed or symlinked
as `pandoc-server` or `pandoc-server.cgi`.

As usual, there are a number of other significant improvements, which
you can read about in the changelog.

API changes:

* New exported module Text.Pandoc.Server [API change].
* Text.Pandoc.Highlighting: Export `lookupHighlightingStyle`.
* Text.Pandoc.App.Opts: The `FromJSON` instance `Opt` now
allows values to be omitted (in which case the values from
`defaultOptions` are used).
* Lua: add function `pandoc.utils.citeproc`.
* Improved https://pandoc.org/try.



==============================================================================
Subject: ANN: pandoc 2.19.2
From:    John MacFarlane
Date:    Aug 22, 2022, 9:28:04 PM
Link:    https://groups.google.com/g/pandoc-announce/c/s_L-uf8hCI8
==============================================================================

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

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

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

This release fixes a regression in 2.19.1 involving data: URIs
and a bug in pandoc-server's handling of the `citeproc` parameter.

It revises the changes of column formatting in HTML from 2.19.1.

Finally, it improves round-tripping between ipynb and Org-mode,
using emacs-jupyter conventions.

See the changelog for details.



==============================================================================
Subject: ANN: pandoc 3.0
From:    John MacFarlane
Date:    Jan 18, 2023, 10:28:00 PM
Link:    https://groups.google.com/g/pandoc-announce/c/oLlA8CLLHdc
==============================================================================

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

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

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

This is a monster release, with many changes (the changelog
is over 1000 lines long).

Significant user-facing changes
-------------------------------

* The main `pandoc` package now contains just the library;
the executable has been moved to `pandoc-cli`. (So, if you
used to `cabal install pandoc` you will now need to
`cabal install pandoc-cli` to get the command-line tool.)

* pandoc now behaves like a Lua interpreter when called as
`pandoc-lua` or when `pandoc lua` is used. The Lua API that
is available in filters is automatically available.
(See the `pandoc-lua` man page.)

* pandoc behaves like a server when called as `pandoc-server`
or when `pandoc server` is used. (See the `pandoc-server`
man page.)

* `pandoc-server` now returns a JSON object if JSON is accepted
(instead of just a JSON-encoded string, as previously). Properties
are `output` (string), `base64` (boolean), and `messages`
(array of string).

* New output format: `chunkedhtml`. This creates a zip file
containing multiple HTML files, one for each section,
linked with "next," "previous," "up," and "top" links.
(If `-o` is used with an argument without an extension,
it is treated as a directory and the zip file is automatically
extracted there, unless it already exists.) The top page will
contain a table of contents if `--toc` is used. A
`sitemap.json` file is also included. The option
`--split-level` determines the level at which sections are
to be split.

* A new command-line option `--list-tables`, causes tables to be
formatted as list tables in RST.

* New command line option: `--epub-title-page=true|false` allows
the EPUB title page to be omitted.

* `--reference-doc` can now accept a URL argument (#8535) and
load a remote reference doc.

* A new option `--split-level` replaces `--epub-chapter-level`
and affects both EPUB and chunked HTML output.
`--epub-chapter-level` will still work but is deprecated.

* These deprecated options have been removed: `--atx-headers`,
`--strip-empty-paragraphs`.

* Add new `mark` extension for highlighted text in Markdown,
using `==` delimiters.

* Add new extensions `wikilinks_title_after_pipe` and
`wikilinks_title_before_pipe` for `commonmark` and `markdown`.
The former enables links of style `[[Name of page|Title]]` and
the latter `[[Title|Name of page]]`.

* In a Markdown fenced code block, a "bare" language can now be
combined with attributes, e.g.

```haskell {.class #id}

* In grid tables, a table foot can be specified by enclosing it
with part separator lines (`+` and `=`):

+------+-------+
| Item | Price |
+======+=======+
| Eggs | 5£ |
+------+-------+
| Spam | 3£ |
+======+=======+
| Sum | 8£ |
+======+=======+

* Improved support for complex figures in many formats. There is
now a dedicated block-level constructor for Figure, and
figures can contain short captions and arbitrary block-level
content. In Markdown the `implicit_figures` extension
currently remains the only way to represent figures, but the
groundwork is there a more flexible figure syntax.

* A new `tagging` extension is now supported for the `context`
writer, for producing tagged PDFs.

* Pandoc no longer looks in `readers` and `writers`
subdirectories of the user data directory to find custom
readers and writers. Scripts in those directories must be
moved to the `custom` folder.

* The `man` writer now uses UTF-8 by default; if you are
generating man pages for a system that does not support UTF-8,
use `--ascii`.

* The default HTML template now uses less opinionated CSS, not
specifying a font size, line height, or font family.
A new `maxwidth` variable sets `max-width`; if not set, 36em is
used as a default.

* We have reduced the use of inline CSS used for EPUBs. Almost
everything is now in the default EPUB CSS, which can be overridden
either by putting `epub.css` in the user data directory or by using
`--css` on the command line. Inline styles are only used for
syntax highlighting (which depends on the style specified, and
is only included on pages with highlighted code) and for bibliography
formatting (which can depend on the CSL style, and is only used in the
page containing the bibliography).

* The Lua subsystem now provides many new useful functions,
allowing even programmatic control over extensions and
formats, templates, zip files, text encodings, CLI options,
embedded media, and division into sections and chunks.

* Classic custom writers are deprecated. The global variables
`PANDOC_DOCUMENT` and `PANDOC_WRITER_OPTIONS` are no longer set
when the writer script is loaded. Both variables are still set in
classic writers before the conversion is started, so they can be used
when they are wrapped in functions. A new function
`pandoc.write_classic` can be used to convert a classic writer into
a new-style writer: see the changelog for an example of its use.

* It is now possible to have a custom reader and a custom writer for
a format together in the same file.

* It is now possible to create a bytestring writer (e.g. one
that produces a zip file).

* Custom readers and writers can now define the extensions that
they support via the global `writer_extensions`.

* Custom writers can define a default template via a global `Template`
function; the data directory is no longer searched for a default
template. See the changelog for instructions on restoring
the old behavior.

API changes
-----------

* pandoc-server, pandoc-cli, and pandoc-lua-engine have been
split off into separate packages (#8309). It is possible to
compile pandoc without Lua or server support, using cabal
flags.

* New module Text.Pandoc.Writers.ChunkedHTML.

* Rename Text.Pandoc.Readers.Odt -> Text.Pandoc.Readers.ODT,
for consistency with Writers.ODT. Rename readOdt -> readODT.

* Rename Text.Pandoc.Writers.Docbook -> Text.Pandoc.Writers.DocBook.
Rename writeDocbook -> writeDocBook, for consistency with
the DocBook reader's naming.

* Text.Pandoc.App:

+ parseOptionsFromArgs and parseOptions now return Either OptInfo Opt.
+ Add OptInfo type.
+ Add handleOptInfo function.
+ convertWithOpts: add argument for a ScriptingEngine.
+ New optEpubTitlePage field on Opt.
+ Remove optEpubChapterLevel, add optSplitLevel.
+ Export IpynbOutput(..).

* New exported module Text.Pandoc.Slides.

* New module Text.Pandoc.Format.

* Text.Pandoc.Sources: Add UpdateSourcePos instances for String and
strict and lazy ByteString.

* Text.Pandoc.Extensions:

+ Fix JSON decoding of Extensions.
+ Add new exported function readExtension.
+ Remove parseFormatSpec. This has been moved to Text.Pandoc.Format and
renamed as parseFlavoredFormat.
+ Add CustomExtension constructor to Extension.
+ Remove Bounded, Enum instances for Extension.
+ Add extensionsToList function.
+ Add showExtension.
+ Add Ext_mark, Ext_tagging, Ext_wikilinks_title_after_pipe,
Ext_wikilinks_title_before_pipe constructors for Extension.

* Text.Pandoc.XML: Export lookupEntity.

* Text.Pandoc.Parsing:

+ Remove gratuitious renaming of Parsec types. We were exporting
Parser, ParserT as synonyms of Parsec, ParsecT.
New (re-)exports: Stream(..), updatePosString, SourceName,
Parsec, ParsecT. Removed exports: Parser, ParserT
+ Export errorMessages, messageString.
+ Export fromParsecError, which can be used to turn a parsec
ParseError into a regular PandocParseError.
+ Remove unused function nested.
+ Change characterReference, charsInBalanced. characterReference
so they now return a Text (some named references don't correspond
to a single Char). Use the the lookupEntity function from
commonmark-hs instead of the slow one from tagsoup.
+ charsInBalanced now takes a Text parser rather than a Char parser
as argument.

* Text.Pandoc.Shared:

+ Export textToIdentifier.
+ Remove deprecated crFilter.
+ Remove deprecated deLink.
+ Deprecate notElemText.
+ Deprecate makeMeta.
+ Remove pandocVersion (now available in Text.Pandoc.Version
as pandocVersionText).
+ Remove findM.
+ Remove deprecated makeMeta.
+ Remove ordNub. Use nubOrd from Data.Containers.ListUtils instead.
+ Remove mapLeft. This is just a synonym for Bifunctor.first.
+ Remove elemText, notElemText.
+ Drop export of pandocVersion and pandocVersionText,
which are now exported by Text.Pandoc.Version.
+ Remove escapeURI, isURI. These are now exported by Text.Pandoc.URI.
+ Use LineBreak as default block sep in blocksToInlines.
+ defaultUserDataDir is no longer exported (it has been
moved to Text.Pandoc.Data).
+ New function figureDiv, offering offers a standardized way
to convert a figure into a Div element.

* Text.Pandoc.Writers.Shared: export htmlAddStyle,
htmlAlignmentToString, and htmlAttrs.

* Text.Pandoc.Options:

+ WriterOptions now has a field writerListTables.
+ New writerEpubTitlePage field on WriterOptions.
+ Remove writerEpubChapterLevel, add writerSplitLevel.

* Text.Pandoc.Filter:

+ Export applyFilters, applyJSONFilter.
+ Parameterize applyFilters over scripting engine.

* New exported module Text.Pandoc.Chunks. This
module provides functions to split Pandoc documents into
chunks to be rendered in separate files, e.g. one per section.

* Text.Pandoc.Readers: change argument type of getReader, so it takes a
FlavoredFormat instead of a Text.

* Text.Pandoc.Writers: change argument type of getWriter, so it takes a
FlavoredFormat instead of a Text.

* New exported module Text.Pandoc.Scripting. The module contains the
central data structure for scripting engines (e.g., Lua).

* Text.Pandoc.Error:

+ Add new PandocError constructors PandocNoScriptingEngine,
PandocFormatError, PandocNoTemplateError.
+ Remove PandocParsecError constructor. Henceforth we just use
PandocParseError.

* New module Text.Pandoc.Version, exporting pandocVersionText
and pandocVersion. pandocVersion returns a Version instead
of a Text.

* Text.Pandoc.Class:

+ Remove exports readDataFile, readDefaultDataFile, setTranslations,
and translateTerm. (See Text.Pandoc.Data, Text.Pandoc.Translations
for these functions.)
+ Export checkUserDataDir.

* New exported module Text.Pandoc.Class.IO.

* Text.Pandoc.Data is now an exported module, providing readDataFile
and readDefaultDataFile (both formerly provided by
Text.Pandoc.Class), and also getDataFileNames (formerly
unexported in Text.Pandoc.App.CommandLineOptions)
and defaultUSerDataDir (formerly provided by Text.Pandoc.Shared).

* New exported module Text.Pandoc.Translations is now an exported module
(along with Text.Pandoc.Translations.Types), providing readTranslations,
getTranslations, setTranslations, translateTerm, lookupTerm,
readTranslations, Term(..), and Translations.

* Text.Pandoc now exports Text.Pandoc.Data and setTranslations
and translateTerm.

* Remove modules Text.Pandoc.Writers.Custom and
Text.Pandoc.Readers.Custom. The functions writeCustom and
readCustom are available from module Text.Pandoc.Lua.

* Text.Pandoc.Server is now in a separate package,
pandoc-server. parseServerOpts has been removed.

* Text.Pandoc.Lua is now in a separate package,
pandoc-lua-engine.

+ Export applyFilter, readCustom, and writeCustom.
+ No longer export the lower-level function runFilterFile.
+ Change type of applyFilter:

applyFilter :: (PandocMonad m, MonadIO m)
=> Environment-> [String]-> FilePath-> Pandoc-> m Pandoc

where Environment is defined in Text.Pandoc.Filter.Environment.
+ Export new function getEngine.
+ The writeCustom function has changed to return a Writer and
an ExtensionsConfig. This allows ByteString writers to be defined.
+ The readCustom function has changed to return a Reader and an
ExtensionsConfig.

---

For a full accounting of the many changes and bug fixes in this
release, see the changelog.

Thanks to all who contributed, including Akos Marton, Albert
Krewinkel, Alexander Batischev, Amar Al-Zubaidi, Amir Dekel,
Aner Lucero, Artem Pelenitsyn, Bastien Dumont, Francesco Occhipinti,
Ian Max Andolina, Ilona, Jeremie Knuesel, Justin Wood, Link Swanson,
Marcin Serwin, Mathias Walter, Olivier Benz, Pranesh Prakash, Prat,
R. N. West, Ruqi, Siphalor, Sven Wick, Terence Eden, TomBen,
Vladimir Alexiev, William Rusnack, Wout Gevaert, lifeunleaded,
nbehrnd, and vkraven.



==============================================================================
Subject: ANN: pandoc 3.0.1
From:    John MacFarlane
Date:    Jan 25, 2023, 8:32:45 PM
Link:    https://groups.google.com/g/pandoc-announce/c/oz67qzdNg3Q
==============================================================================

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

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

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

This is a bug-fix release. It fixes a couple of regressions
and other bugs in pandoc 3.0. We recommend upgrading from pandoc 3.0.



==============================================================================
Subject: ANN: pandoc 3.1
From:    John MacFarlane
Date:    Feb 10, 2023, 7:45:11 AM
Link:    https://groups.google.com/g/pandoc-announce/c/vUAw110eIpc
==============================================================================

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

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

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

This version adds a new option --chunk-template, giving the user more
control over the filenames in chunked HTML output.

There are several other bug fixes and minor improvements.

API changes:

* Text.Pandoc.App: Add optChunkTemplate constructor to Opt.
* Text.Pandoc.Options: add writerChunkTemplate constructor to WriterOptions.
* Text.Pandoc.Chunks: add Data, Typeable, Generic, ToJSON, FromJSON
instances for PathTemplate.

Thanks to all who contributed, especially new contributors
Daniel Kessler, Martin Joerg, and Stephen Altamirano.



==============================================================================
Subject: ANN: pandoc 3.1.1
From:    John MacFarlane
Date:    Mar 6, 2023, 12:21:52 AM
Link:    https://groups.google.com/g/pandoc-announce/c/jibN6SZ9cwY
==============================================================================

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

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

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

Mostly this is a bugfix release. There are two changes to the
Lua API:

- New function pandoc.system.cputime
- New module pandoc.json for JSON conversion

Thanks to all who contributed, especially new contributors
Mikołaj Machowski, Morgan Willcock, Pavol Otto, and arcnmx.



==============================================================================
Subject: ANN: pandoc 3.1.2
From:    John MacFarlane
Date:    Mar 28, 2023, 2:05:34 AM
Link:    https://groups.google.com/g/pandoc-announce/c/4ZOZr7S56pQ
==============================================================================

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

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

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

Some exciting new features in this release:

- Support for output in Typst, a new TeX alternative
with incremental compilation and many nice features
(https://typst.app).

- typst is also supported as a --pdf-engine.

- 'pandoc lua -i' can be used to open a Lua REPL
with the pandoc environment preloaded. You can also instruct
a filter to open a REPL at a certain point, using 'pandoc.cli.repl'.
This should make it much easier to debug Lua filters.

- We now provide macOS binary releases compiled for Apple silicon.

Thanks to all who contributed, especially Albert Krewinkel
for his work on the Lua subsystem, and new contributors
Amy de Buitléir, Andres Freund, Christian Christiansen, and
Martín Pozo.



==============================================================================
Subject: ANN: pandoc 3.1.3
From:    John MacFarlane
Date:    Jun 7, 2023, 6:49:24 AM
Link:    https://groups.google.com/g/pandoc-announce/c/D4Msdb58Qt8
==============================================================================

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

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

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

The main new feature is a typst reader, which depends
on a new Haskell library for parsing and evaluating
typst expressions. (This turned out to be quite a project,
because typst is a fairly full-featured programming language
in its own right.) Typst support isn't perfect, but it
should be good enough now to be useful. Typst 0.4 is the
version supported.

API change: new exposed module, Text.Pandoc.Readers.Typst.

For other changes and bug fixes, see the changelog.

Thanks to all who contributed, especially new contributors
Andreas Scherer, Charlotte Koch, Frank Seifferth, Matt Dodson,
Michael Stahl, Noah Malmed, Stephan Meijer, Toni Dietze,
perro tuerto, sdhoward, thron7, and wgevaert.

John MacFarlane
unread,
Jun 7, 2023, 6:47:08 PM



to pandoc-...@googlegroups.com, pandoc-...@googlegroups.com
And, fun fact, pandoc can now be used as a calculator:

% pandoc -f typst -t plain
#(3 * calc.sin(90))
2.6819899908016733



> On Jun 6, 2023, at 9:49 PM, John MacFarlane <fiddlo...@gmail.com> wrote:
>
> I'm pleased to announce the release of pandoc 3.1.3,
> available in the usual places:
>
> Binary packages & changelog:
> https://github.com/jgm/pandoc/releases/tag/3.1.3
>
> Source & API documentation:
> http://hackage.haskell.org/package/pandoc-3.1.3
>
> The main new feature is a typst reader, which depends
> on a new Haskell library for parsing and evaluating
> typst expressions. (This turned out to be quite a project,
> because typst is a fairly full-featured programming language
> in its own right.) Typst support isn't perfect, but it
> should be good enough now to be useful. Typst 0.4 is the
> version supported.
>
> API change: new exposed module, Text.Pandoc.Readers.Typst.
>
> For other changes and bug fixes, see the changelog.
>
> Thanks to all who contributed, especially new contributors
> Andreas Scherer, Charlotte Koch, Frank Seifferth, Matt Dodson,
> Michael Stahl, Noah Malmed, Stephan Meijer, Toni Dietze,
> perro tuerto, sdhoward, thron7, and wgevaert.
>
>



==============================================================================
Subject: SECURITY: arbitrary file write vulnerability
From:    John MacFarlane
Date:    Jun 20, 2023, 11:17:20 PM
Link:    https://groups.google.com/g/pandoc-announce/c/7NxalnVXN70
==============================================================================

Entroy C has discovered a security vulnerability in pandoc, affecting all recent versions of pandoc (and probably versions as old as 1.13).   The vulnerability affects the MediaBag mechanism and allows users to write arbitrary files to any location by feeding pandoc an image element with a specially crafted URL when using --extract-media or creating a PDF.  The vulnerability is serious for anyone using pandoc to process untrusted input.  The vulnerability does not affect pandoc when run with the --sandbox flag.

The vulnerability is fixed in commit 5e381e3878b5da87ee7542f7e51c3c1a7fd84b89 in the main branch of the pandoc repository.

It can also be avoided by using --sandbox (which we recommend anyway when processing untrusted input).

I plan to put out a release with this fix soon, but I wanted to announce the vulnerability now, since the commit is now visible in a public repository.

Many thanks to Entroy C for finding the issue.



==============================================================================
Subject: ANN: pandoc 3.1.4
From:    John MacFarlane
Date:    Jun 24, 2023, 11:52:58 PM
Link:    https://groups.google.com/g/pandoc-announce/c/5O0zpk9YTmE
==============================================================================

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

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

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

The main reason for this release is to fix a security vulnerability found by
Entroy C. This vulnerability affects earlier versions of pandoc and is only
present when output is to a PDF or --extract-media is used. Using a specially
crafted data URI in an image element, an attacker can cause pandoc
to write files with arbitrary contents and filenames to locations outside of
the directory to which media is being extracted. Using --sandbox does not
mitigate this vulnerability (as documented, --sandbox only limits IO in
readers and writers and does not affect PDF production).

We recommend that all users upgrade.

In addition to this security fix, this release contains a number of
small improvements, described in the changelog.

There is one small API change: the `ScriptingWarning` constructor
has been added to `LogMessage`.

Thanks to all who contributed, especially new contributors Adelar da Silva
Queiróz, Norwid Behrnd, Per Christian Gaustad, ech0, and harabat. And thanks
especially to Entroy C for identifying the security issue.



==============================================================================
Subject: ANN: pandoc 3.1.5
From:    John MacFarlane
Date:    Jul 7, 2023, 6:41:12 PM
Link:    https://groups.google.com/g/pandoc-announce/c/gSIhVv-GbV4
==============================================================================

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

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

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

The main focus of this release is improvements in the typst reader.
Typst 0.6 is now targeted, and quite a few bugs have been fixed.

All boolean command-line flags may now take an optional value
(true or false). So, instead of --standalone you can use
--standalone=true. This is convenient when you need to override
a boolean flag that is set in a defaults file.

There is also an important behavior change in the asciidoc writer.
The asciidoc output format now targets the dialect parsed by
asciidoctor, which the community now regards as the official
syntax, rather than the dialect parsed by asciidoc.py, the
legacy processor. If you want the old behavior, use the new
asciidoc_legacy format. The format asciidoctor will still work,
but it is now a deprecated synonym for asciidoc.

API changes:

* In Text.Pandoc.Writers.AsciiDoc:

- writeAsciiDoc now behaves like writeAsciiDoctor used to.
- writeAsciiDoctor is now a deprecated synonym for writeAsciiDoc.
- New function writeAsciiDocLegacy behaves like writeAsciDoc used to.

* In Text.Pandoc.Class: New exported function toTextM. This is like
Text.Pandoc.UTF8.toText, except that it takes a file path as first
argument, in addition to bytestring contents, and it raises an
informative error with source position if the contents are not
UTF8-encoded.

Thanks to all who contributed, especially new contributors
Sam S. Almahri, Kevin Broch, and pacien.



==============================================================================
Subject: ANN: pandoc 3.1.6
From:    John MacFarlane
Date:    Jul 21, 2023, 5:40:35 PM
Link:    https://groups.google.com/g/pandoc-announce/c/5wtr5H-0hsY
==============================================================================

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

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

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

Changes of note:

This release fixes a new variant of the vulnerability described in
CVE-2023-35936. Guilhem Moulin noticed that the fix in 3.1.4 to
CVE-2023-35936 was incomplete. An attacker could get around it by
double-encoding the malicious extension to create or override
arbitrary files.

A regression on short boolean arguments has also been fixed.
In 3.1.5 boolean arguments were allowed an optional argument
(`true|false`). This broke the ability to used fused short
arguments, e.g. '-somyfile.html' == '-s -o myfile.html'. This
commit restores that while keeping support for optional boolean
arguments.

--embed-resources now uses inline SVG instead of data URIs for SVG
images in HTML5.

The docx reader will now use the SVG version of an image if present
rather than the PNG fallback.

The typst reader fixes a regression in recognition of display math
and has many bug fixes from improvements in typst-hs.

Release binaries are now compiled on ghc 9.2, since compiling on 9.4
led to "illegal instruction" errors on some older hardware.
(The cause of this is still not clear, but the change seems to
have fixed the problem.)

See the changelog for other changes and fuller details.



==============================================================================
Subject: ANN: pandoc 3.1.6.1
From:    John MacFarlane
Date:    Aug 7, 2023, 4:21:35 AM
Link:    https://groups.google.com/g/pandoc-announce/c/xHfGDnuD5PU
==============================================================================

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

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

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

This is mainly a bugfix release. It fixes several regressions, affecting:

- MathJax in ChunkedHTML,
- SVG images with `--embed-resources`,
- `toJSONFilter` with functions instantiating `a -> [a]`,
- tables with row headers in HTML.

In addition, syntax highlighting now works with the ODT writer.
Thanks to all who contributed or submitted bug reports.



==============================================================================
Subject: ANN: pandoc 3.1.6.2
From:    John MacFarlane
Date:    Aug 23, 2023, 1:53:47 AM
Link:    https://groups.google.com/g/pandoc-announce/c/f9BoD5syFOg
==============================================================================

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

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

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

Again, mostly a bugfix release (see changelog for details).
Typst support has changed to target typst 0.7.

Thanks to all who contributed or submitted bug reports, especially
new contributors Jackson Schuster and Julia Diaz.



==============================================================================
Subject: ANN: pandoc 3.1.7
From:    John MacFarlane
Date:    Aug 31, 2023, 10:16:13 PM
Link:    https://groups.google.com/g/pandoc-announce/c/dP14ahV6ihc
==============================================================================

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

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

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

There are many small changes and improvements (see the changelog),
but the main impetus for a release so soon on the heels of the last
one was a couple of regressions, involving escaping of URLs and
internal links in LaTeX.

Some other improvements of special note:

* Man output has been cleaned up so it is more standard and more
portable (thanks to Ingo Schwarze and G. Branden Robinson for advice
on this). We have reverted the fancy but non-portable font treatment
introduced in #7506.
* We depend on a new skylighting version that works around an iOS Safari
bug that caused funny font size shifts in our highlighted code.
* We use `\cite` and `\bibitem` even with citeproc now, which gives
better accessibility (thanks to Ulrike Fischer for advice).

Thanks to all who contributed or submitted bug reports, especially
new contributors Amneesh Singh and João Alvim.



==============================================================================
Subject: ANN: pandoc 3.1.8
From:    John MacFarlane
Date:    Sep 9, 2023, 8:30:02 PM
Link:    https://groups.google.com/g/pandoc-announce/c/n0PlwcdC24E
==============================================================================

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

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

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

This release fixes some regressions due to the changes in internal links
in LaTeX from 3.1.7 and improves citeproc formatting issues in LaTeX.
See the changelog for details.

Thanks to all who contributed or submitted bug reports, especially
new contributors Benjamin Esham and John Purnell.



==============================================================================
Subject: ANN: pandoc 3.1.9
From:    John MacFarlane
Date:    Oct 28, 2023, 3:14:45 AM
Link:    https://groups.google.com/g/pandoc-announce/c/n1CPQ10anhE
==============================================================================

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

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

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

This release includes a number of small bug fixes and new features.
Most notably:

- Pandoc can now read the BITS dialect of JATS (bits is a new input
format).
- A new extension tex_math_gfm supports math formats that are specific
to GFM (inline math with $`..`$ delimiters and display math in a code
block marked 'math'). It is enabled by default for gfm.

API changes:

- In Text.Pandoc.Extensions Ext_tex_math_gfm is a new constructor
for Extensions.
- Text.Pandoc.Shared now exports addPandocAttributes.

See the changelog for full details

Thanks to all who contributed or submitted bug reports, especially
Julia Diaz for improvements to the JATS reader, and new contributors
James J Balamuta, John Purnell, Michael McClurg, Seth Speaks,
Stephan Daus, Tim Stewart, 3w36zj6, piq9117, priiduon, and samuel-weinhardt.



==============================================================================
Subject: ANN: pandoc 3.1.10
From:    John MacFarlane
Date:    Dec 12, 2023, 8:10:00 PM
Link:    https://groups.google.com/g/pandoc-announce/c/_WkNE24ZLSs
==============================================================================

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

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

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

Some changes of note (in addition to many small improvements
and bug fixes):

* Henceforth the pandoc-cli version will be synced with the pandoc
version, so using cabal or stack to install pandoc-cli-3.1.10
will get you pandoc version 3.1.10. This means that we will always
release a new version of pandoc-cli when we release a new version
of pandoc.

* There is a new commonmark extension, alerts, that enables
GitHub style markdown alerts (warning, tip, etc.). This currently
doesn't work with pandoc's markdown, only with commonmark and variants. It is
enabled by default for gfm. For more on alerts, see
https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts .

* Typst support has been updated to typst v0.10.0 (though support is only
partial). Typst can now use CSL styles for citations (specify `csl`
in the metadata or as a variable when writing typst).

* Word styles now use "Footnote Block Text" instead of "Block Text" style
for block quotes inside footnotes. (This allows you to select a
smaller font, as might be appropriate for footnotes.)

* In HTML output, the doc-footnote aria-role is now used with the
aside element, and doc-endnotes with section. aside is only used
for notes at the ends of sections or blocks; if all the notes come
at the end of the document, section is used so we can have the
doc-endnotes role.

* In man and ms output, ASCII hyphens (-) are now backslash-escaped.
The `groff_man (7)` man page indicates that `-` characters will be
treated as typographic hyphens and are not appropriate for cases
where the output should be copy-pasteable as an
ASCII hyphen-minus character. (E.g. in command line options.)
However, until a recent update groff man did not actually do this;
it treated `-` and `\-` the same. With the new update (1.23.0)
the two are distinguished (see https://lwn.net/Articles/947941/
for background), so now it is important that pandoc escape `-`.

* Better treatment of embedded SVGs.

API changes:

* Text.Pandoc.Extension: add Ext_alerts constructor for Extension.
* Text.Pandoc.Shared: export combineAttr.

Thanks to all who contributed or submitted bug reports, especially
new contributor Hikaru Ibayashi.



==============================================================================
Subject: ANN: pandoc 3.1.11
From:    John MacFarlane
Date:    Dec 16, 2023, 4:56:16 AM
Link:    https://groups.google.com/g/pandoc-announce/c/cfRtk33mInU
==============================================================================

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

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

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

Typst support has been improved, and in producing PDFs via LaTeX,
pandoc now tries to determine the proper number of runs by parsing
the log file. This should fix issues some users of custom templates have had
after upgrading to 3.1.10, which reduced the number of runs.



==============================================================================
Subject: ANN: pandoc 3.1.11.1
From:    John MacFarlane
Date:    Jan 6, 2024, 3:44:12 AM
Link:    https://groups.google.com/g/pandoc-announce/c/sd2ig3IipWA
==============================================================================

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

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

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

This release fixes a number of bugs. Some highlights:

- Fixed a regression in PDF production from 3.1.9. In some cases
LaTeX was not being run enough times.
- Thanks to the work of Edwin Török, the docx writer now produces
conformant XML. (The validation failures didn't seem to affect
Word's ability to display the docx files produced by pandoc,
but they may matter for other consumers of docx.)
- Validation failures in ODT output have also been fixed.
- The Markdown writer now includes table identifiers at the end
of the caption, if present.

Thanks to new contributor Edwin Török.



==============================================================================
Subject: ANN: pandoc 3.1.12
From:    John MacFarlane
Date:    Feb 15, 2024, 7:20:50 PM
Link:    https://groups.google.com/g/pandoc-announce/c/Joy2hBTmyfI
==============================================================================

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

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

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

This release fixes a number of issues (especially in typst, EPUB, PDF,
and chunked HTML output) and adds some new features. It is recommended
that everyone upgrade.

Highlights of this release:

* Pandoc now supports djot as both an input and output format.
Djot is a light markup syntax (https://djot.net).

* --number-sections now uses the first digit for the number of
the top-level section, no matter what its level. So if the top-level
section of the document is level-2, numbers will be 1, 2, etc. rather than
0.1, 0.2, as in the past (#5071). For some backwards compatibility,
we revert to the old behavior when the --number-offset option is used.

* When `--section-divs` is used, or when output is EPUB or chunked HTML,
we no longer ensure that the sequence of heading levels is gapless.
So, an author who wants to leave a gap between level-2 and level-4
headings can do so, and this will be preserved.

* The empty_paragraphs extension now works with the LaTeX writer.

* Pandoc's EPUB now contain the accessibility metadata required by the
EU Accessibility Act.

* Pandoc's docx output now validates.

* The man writer now supports (limited) syntax highlighting (only
boldface, underline and italics make a difference).

* Font fallbacks are now support for LuaLaTeX and ConTeXt. This should
make it easier to support documents with unusual symbols and multilingual
documents.

API changes:

* New module Text.Pandoc.Readers.Djot [API change]. The function
readDjot is also exported by Text.Pandoc.Readers.

* New module Text.Pandoc.Writers.Djot [API change]. The function
writeDjot is also exported by Text.Pandoc.Writers.

* readMan is now exported from Text.Pandoc.Readers.

Thanks to everyone who contributed, particularly to Edwin Török for help with
docx validation and to new contributors George Stagg, Gokul Rajiv, Iacobus1983,
Lawrence Chonavel, Max Heller, Sam May, Tomas Dahlqvist, lawcho, and
mh4ckt3mh4ckt1c4s.



==============================================================================
Subject: ANN: pandoc 3.1.12.1
From:    John MacFarlane
Date:    Feb 18, 2024, 2:46:06 AM
Link:    https://groups.google.com/g/pandoc-announce/c/X4_sagWcpUo
==============================================================================

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

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

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

This is just a small bugfix release to repair some regressions
affecting EPUB v2 and --self-contained output with SVGs.

It also fixes a bug with math in Powerpoint output.



==============================================================================
Subject: ANN: pandoc 3.1.12.2
From:    John MacFarlane
Date:    Mar 1, 2024, 7:02:33 AM
Link:    https://groups.google.com/g/pandoc-announce/c/Bmz6LFOecMw
==============================================================================

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

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

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

This is a bugfix release to repair some more 3.1.12 regressions.



==============================================================================
Subject: ANN: pandoc 3.1.12.3
From:    John MacFarlane
Date:    Mar 18, 2024, 6:34:47 AM
Link:    https://groups.google.com/g/pandoc-announce/c/deMgAc7uaYo
==============================================================================

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

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

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

This is a bugfix release to repair some 3.1.12 regressions
and a few other issues.



==============================================================================
Subject: ANN: pandoc 3.1.13
From:    John MacFarlane
Date:    Apr 7, 2024, 5:52:59 PM
Link:    https://groups.google.com/g/pandoc-announce/c/C0ghQTKgcN4
==============================================================================

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

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

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

The biggest change in this version is improved support for
Typst 0.11 (including the new table features). All pandoc table
features except row heads are now support for Typst (both input
and output).

Note that the default Typst template has been modified so that
tables don't have border lines by default (except under a
header or over a footer). If you'd like a different format
you can easily add a different default stroke pattern in a
custom template or with header includes.

API change: Text.Pandoc.Writers.Shared now exports isOrderedListMarker.

Thanks to all who contributed!



==============================================================================
Subject: ANN: pandoc 3.2
From:    John MacFarlane
Date:    May 11, 2024, 11:12:16 PM
Link:    https://groups.google.com/g/pandoc-announce/c/LrCIO9fWisw
==============================================================================

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

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

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

This release includes a number of bug fixes; inspect the changelog
for details. Some changes of particular note:

* Markdown numbered example lists with repeated labels now do something
more sensible.
* --file-scope no longer adds Divs with an identifier derived from the
filename.
* The LaTeX template now has a titlegraphicoptions variable.
* custom-style now works for spans in ODT.
* The Typst writer now allows extensive customization of elements
through specially marked attributes that can be added in filters.
* The default output for docx is now closer to Word's own defaults.
* Better control over logging in Lua filters.

API changes:

* New module Text.Pandoc.Transforms.
* Text.Pandoc.Shared no longer exports headerShift, filterIpynbOutput,
or eastAsianLineBreakFilter; these have been moved to Text.Pandoc.Transforms.
* Text.Pandoc.Logging: New ScriptingInfo, UnsupportedCodePage, and UnclosedDiv
constructors for LogMessage. DocxParserWarning is now a WARNING, not INFO.
* Text.Pandoc.Writers.Shared now exports isOrderedListMarker.

Thanks to all who contributed, and a special welcome to new contributors
Gordon Woodhall, James P. Ascher, Leo Heitmann Ruiz, guqicun, and mbracke.



==============================================================================
Subject: ANN: pandoc 3.2.1
From:    John MacFarlane
Date:    Jun 24, 2024, 11:36:38 PM
Link:    https://groups.google.com/g/pandoc-announce/c/dfWwjo9bbLA
==============================================================================

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

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

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

Some changes of particular note (inspect changelog for the full list):

* Improve caption, table, and task list handling in docx reader.
* Major improvements in texinfo output.
* OpenXML templates may now be used to customize the contentsn of
docx output in ways that are not possible with --reference-doc.
For example, the order in which metadata and the table of contents
can be changed, and boilerplate text can be added. See the
default openxml template for a sample.
* --include-before-body and --include-after-body now work with
docx output. The included files must be OpenXML fragments
suitable to be included in the document body.
* HTML tables produced by pandoc no longer include 'header', 'even'
or 'odd' classes on tr elements. Compatibility warning:
those who relied on these classes to style tables may need to
adjust their CSS, using standard selectors like
'tbody tr:nth-child(2n)'.
* We use a new method to ensure that images don't overflow text
bounds in LaTeX output. The old approach was brittle and caused
problems with SVGs. The new approach uses a new macro,
\pandocunbounded, defined in the default LaTeX template.
Those who use custom templates will need to include this
definition in their templates. In addition, note that
if explicit dimensions are specified for images, these images
may now overflow the page.
* The Typst writer has additional support for fine-grained properties,
allowing the user to control whether a figure is produced for a table,
and what kind of figure is produced for a figure. See
doc/typst-property-output.md for details.
* With --embed-resources, SVGs are no longer inlined unless the image has
the class 'inline-svg'. By default data URIs are used.

API changes:

* Text.Pandoc.Writers.Shared exports toTaskListItem.

Thanks to all who contributed, and a special welcome to new contributors
Mickaël Canouil and Thomas Soeiro.



==============================================================================
Subject: ANN: pandoc 3.3
From:    John MacFarlane
Date:    Jul 29, 2024, 2:20:28 AM
Link:    https://groups.google.com/g/pandoc-announce/c/jZCgDRwCxKE
==============================================================================

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

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

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

Some changes of particular note (inspect changelog for the full list):

* The docx writer fixes a serious regression with nested lists,
introduced in the last release (3.2.1).

* New cli option: `--link-images`. This causes images to be linked
rather than embedded in ODT.

* `--number-sections` can now take an optional `true|false` argument,
like other flag arguments.

* Improved localization support for labels like "Figure," with many
new languages supported.

* re and lpeg modules are now loaded differently in Lua filters.
They are now treated as if they have been loaded by 'require'.
If you desire the old behavior, which allowed you to replace
our built-in re and lpeg modules with system modules by
requiring them, a workaround is described in the changelog.

API changes:

* New field in WriterOptions: writerLinkImages.
* New field in Opt: optLinkImages.

Thanks to all who contributed, and a special welcome to new contributors
Stephen Huan and Jens Oehlschlägel.



==============================================================================
Subject: ANN: pandoc 3.4
From:    John G Macfarlane
Date:    Sep 10, 2024, 7:34:23 PM
Link:    https://groups.google.com/g/pandoc-announce/c/MErHu8bqhUk
==============================================================================

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

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

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

Some changes of particular note (inspect changelog for the full list):

* New output format: ansi (for formatted console output).
* 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).
* --number-offsets now works with docx output.

API changes:

* New module: Text.Pandoc.Writers.ANSI, exporting writeANSI.
* Text.Pandoc.Options: Add CaptionPosition and new WriterOptions fields
writerFigureCaptionPosition and writerTableCaptionPosition.
* Text.Pandoc.Opt: Add Opt fields optFigureCaptionPosition and
optTableCaptionPosition.
* Text.Pandoc.Shared: Add makeSectionsWithOffsets. Remove
stripEmptyParagraphs.
* Text.Pandoc.Highlighting: Add formatANSI.
* Text.Pandoc.Writers.Shared: add toSubscriptInline, toSuperscriptInline.

Thanks to all who contributed, and a special welcome to new contributors
Evan Silberman (who created the ANSI writer and modified doclayout to
make it possible), Jonathan, Pau RE, Sebbones, Tristano Ajmone,
closeobserve, and thomjur.



==============================================================================
Subject: ANN: pandoc 3.5
From:    John G Macfarlane
Date:    Oct 5, 2024, 11:13:59 PM
Link:    https://groups.google.com/g/pandoc-announce/c/8Gcb8EJeLXI
==============================================================================

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

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

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

Some changes of particular note (inspect changelog for the full list):

* The default LaTeX template has been refactored using partials. There
is now a separate template for beamer (previously, the same
conditional-ridden template was used for both). This should make
customizing the templates more straightforward. Note: old custom
templates should still work, but if you are relying on a
version of `default.latex` in `$DATADIR/templates` in creating
beamer files, you will need to create a symlink or duplicate in
the same directory called `default.beamer`.
* The new Beamer template supports a number of new variables,
allowing further customization.
* New command-line options `--list-of-figures/--lof` and
`--list-of-tables/--lot`, affecting docx, latex, context.
* Defaults files: interpolation of environment variables now
works for `to` and `from` fields of defaults files, which is
useful when these contain paths of custom readers and writers.
* In Lua filters, you can now use an 'at' method to access indices,
and you can construct a list using an iterator,
e.g., "pandoc.List(text:gmatch '%S+')".

API changes:

* Text.Pandoc.Class: export extractURIData.
* Text.Pandoc.Options: add writerListOfFigures and writerListOfTables fields
to WriterOptions.
* Text.Pandoc.App: add optListOfFigures and optListOfTables to Opt.

Thanks to all who contributed, and a special welcome to new contributors
Akash Patel, Martin Michlmayr, and Yehuda Katz.



==============================================================================
Subject: ANN: pandoc 3.6
From:    John G Macfarlane
Date:    Dec 8, 2024, 6:46:16 AM
Link:    https://groups.google.com/g/pandoc-announce/c/ceUwLztmAc0
==============================================================================

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

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

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

Some changes of particular note (inspect changelog for the full list):

* mdoc is now supported as an output format.
* --sandbox now affects --embed-resources; previously --embed-resources
or --self-contained could leak data from the file system even if used
with --sandox.
* Support for index entries in docx reader.
* Many improvements to RST parsing.
* Typst, LaTeX, and ConTeXt template changes.
* Prefixes removed form Lua type names.

API changes:

* New module Text.Pandoc.Readers.Mdoc, exporting readMdoc.
* In Text.Pandoc.ImageSize, new Webp constructor on ImageType.
* Text.Pandoc.Logging: new YamlWarning constructor on LogMessage.
* New module Text.Pandoc.Readers.Roff.Escape exporting escape,
escapeArg, RoffLikeLexer(..).

Thanks to all who contributed, especially Evan Silberman
for the new mdoc reader, and a special welcome to new contributors
Andreas Deininger, Luis Rivera and Suraj Patil.



==============================================================================
Subject: ANN: pandoc 3.6.1
From:    John G Macfarlane
Date:    Dec 23, 2024, 8:55:47 PM
Link:    https://groups.google.com/g/pandoc-announce/c/xZwGj3FVOGE
==============================================================================

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

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

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

This release fixes a few regressions introduced in pandoc 3.6 and 3.5:

* Explicit reference links in RST now work properly (regression from 3.6).
* The Word writer now properly styles the title block even when a
localized version is being run (regression from 3.5).
* Generation of PDFs via wkhtmltopdf now works again (regression from 3.6).

Some other changes of note:

* Fix slow performance for files containing very large data URIs.
* A YAML bibliography passed no longer needs to be a YAML object
with a 'references' key; it can just be an array of references.
* --template can now be used with files without an extension,
including bash process substitutions.
* The docx writer now handles chapters better. If
--top-level-divison=chapter is used, chapters will start on a
new page and footnote numbering will restart for each chapter.
(Both these defaults can be overridden in reference.docx.)

See the changelog for full details on what has changed.

Thanks to all who contributed.



==============================================================================
Subject: ANN: pandoc 3.6.2
From:    John G Macfarlane
Date:    Jan 12, 2025, 11:41:26 PM
Link:    https://groups.google.com/g/pandoc-announce/c/QblU4bQXHWc
==============================================================================

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

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

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

This release adds a new reader for the POD (Plain Old Documentation)
used in Perl documentation. It also fixes several bugs, including
a few regressions introduced in pandoc 3.6:

* EPUB v2 cover images should now work again.
* Parsing of underscores in RST should now work again.

API changes:

* New reader module Text.Pandoc.Readers.Pod, exporting readPod.

See the changelog for full details on what has changed.

Thanks to all who contributed, especially Evan Silberman for the
new POD reader and new contributors Santiago Zarate and Stéphane
Guillou.



==============================================================================
Subject: ANN: pandoc 3.6.3
From:    John G Macfarlane
Date:    Feb 9, 2025, 11:11:39 PM
Link:    https://groups.google.com/g/pandoc-announce/c/6yhD2CSkM6E
==============================================================================

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

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

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

No new features in this release, just a bunch of bug fixes and small
improvements. I want to call attention to two behavior changes:

- We now use a "wikilinks" class rather than setting the title
attribute to distinguish wikilinks from regular links.
- We have changed babel support in the LaTeX writer in a way
that should better support most European languages.
If you are using a custom LaTeX template, you may need to
revise it. babeloptions and csquotesoptions variables may now
be specified to fine-tune language support.

Thanks to all who contributed, especially new contributors Hendrik Erz,
Mark Gardner, Sen-wen Deng, Stephen Reindl, Charles Tapley Hoyt, and
Jez Cope.



==============================================================================
Subject: ANN: pandoc 3.6.4
From:    John G Macfarlane
Date:    Mar 16, 2025, 8:13:31 PM
Link:    https://groups.google.com/g/pandoc-announce/c/Z2qj4TdB_Ws
==============================================================================

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

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

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

This is mostly a bug fix release. It incorporates new
versions of the typst and texmath libraries, which should result
in more accurate parsing and rendering. Changes of special note:

- We have made a small change in how pandoc parses list items,
which makes it closer to commonmark and avoids some bad
outcomes. But if you're using HTML comments to comment out
list items, this may result in an unwanted behavior change.
Please see the changelog for details.
- The citations extension is now automatically disabled in the
output format if --citeproc is used, to ensure that the generated
citations will be used instead of native citation codes.
- The warning for unspecified title in HTML output is now
an info-level message; use --verbose if you want to see it.

Thanks to all who contributed, especially new contributors
Olivier Dossmann, Tiago-Manzato, etclub, and josch.



==============================================================================
Subject: ANN: pandoc 3.7
From:    John G Macfarlane
Date:    May 15, 2025, 7:41:48 AM
Link:    https://groups.google.com/g/pandoc-announce/c/eCLj7HQbOnY
==============================================================================

I'm 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 can't 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.



==============================================================================
Subject: ANN: pandoc 3.7.0.1
From:    John G Macfarlane
Date:    May 17, 2025, 10:03:36 PM
Link:    https://groups.google.com/g/pandoc-announce/c/oWnQzyoLa3E
==============================================================================

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

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

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

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



==============================================================================
Subject: ANN: pandoc 3.7.0.2
From:    John G Macfarlane
Date:    May 29, 2025, 9:24:49 AM
Link:    https://groups.google.com/g/pandoc-announce/c/_G-nkTQJzV8
==============================================================================

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

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

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

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.

Thanks to all who contributed, especially new contributor GHyman83.



==============================================================================
Subject: ANN: pandoc 3.8
From:    John G Macfarlane
Date:    Sep 7, 2025, 12:25:13 AM
Link:    https://groups.google.com/g/pandoc-announce/c/ptOvMnBd3oo
==============================================================================

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

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

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

This release comes with many small improvements and a few larger ones.
Among the more visible changes:

+ A new input/output format xml, which exactly represents a pandoc
  AST in a more easily human-readable form than JSON. The format is
  documented in doc/xml.md, and schemas can be found in tools/pandoc-xml.*.

+ A new command line option --syntax-highlighting, which takes the
  values 'none', 'default', 'idiomatic', a style name, or a path to
  a theme file.  --no-highlighting and --highlight-style are deprecated.

+ New extensions smart_quotes and special_strings for org mode.
  These allow pandoc's parsing to more closely reproduce Emacs org-mode's
  behavior.

+ The old compact_definition_lists extension has been removed.

API changes:

+ New modules Text.Pandoc.Readers.XML (exporting readXML) and
  Text.Pandoc.Writers.XML (exporting writeXML).

+ Text.Pandoc.Extensions: added constructors Ext_smart_quotes,
  Ext_special_strings; removed Ext_compact_definition_lists.

+ Text.Pandoc.App now exports versionInfo, a function that takes
  three parameters that can be filled in by pandoc-cli.

+ Text.Pandoc.Parsing: tableWith and tableWith' now return
  a list of lists of Blocks, allowing for multiple header rows.

+ Text.Pandoc.ImageSize: Add Point and Pica as constructors of
  ImageSize.  Add Avif constructor of ImageType.

+ Text.Pandoc.Class: CommonState is now opaque and does not support
  its fields.  To compensate for this, we now export several
  new functions: getRequestHeaders, setRequestHeaders, getSourceURL,
  getTrace.

Thanks to all who contributed, especially new contributors
Christopher Kenny, Erik Post, Repetitive, Reuben Thomas, Ryan Gibb,
Sean Soon, and massifrg.


==============================================================================
Subject: ANN: pandoc 3.8.1
From:    John G Macfarlane
Date:    Sep 29, 2025, 5:02:20 PM
Link:    https://groups.google.com/g/pandoc-announce/c/IJLu2XE3458
==============================================================================

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

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

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

This release introduces a few new features and fixes some bugs
and regressions. Of special note:

- New output format vimdoc (for Vim documentation).
- --syntax-highlighting now works as expected for typst output.
- New shorthands variable allows activating babel shorthands
in LaTeX/PDF output.
- Removed coloring for links in epub.css, so that the reader's
defaults will be used.

API changes:

- New module Text.Pandoc.Writers.Vimdoc, exporting writeVimdoc.
- Text.Pandoc.Parsing: new functions tableWithSpans,
tableWithSpans', toTableComponentsWithSpans, and
toTableComponentsWithSpans'.
- Text.Pandoc.Shared: new function removeLinks.
- Text.Pandoc.Highlighting: export functions formatTypstBlock,
formatTypstInline, styleToTypst (from skylighting).

Thanks to all who contributed, especially Tuong Nguyen Manh (who
has been working hard to improve table support) and new contributors
Raymond Berger and reptee.



==============================================================================
Subject: ANN: pandoc 3.8.2
From:    John G Macfarlane
Date:    Oct 5, 2025, 11:27:19 PM
Link:    https://groups.google.com/g/pandoc-announce/c/U22SFKZE9Wk
==============================================================================

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

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

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

This release fixes a regression in the typst template (since 3.8), which caused links to be omitted.

It also adds a new default Markdown extension, `table_attributes`, which allows attributes to be added to tables by putting them after the caption.

API change: Add `Ext_table_attributes` constructor to Extension.

Thanks to all who contributed.


==============================================================================
Subject: ANN: pandoc 3.8.2.1
From:    John G Macfarlane
Date:    Oct 20, 2025, 12:49:58 PM
Link:    https://groups.google.com/g/pandoc-announce/c/2fL8NOciq_A
==============================================================================

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

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

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

This is primarily a bug-fix release. There are no API changes.

The main motivation for the release is to fix a serious performance
regression with `--citeproc` and the default CSL style,
chicago-author-date.csl. This style was recently revised in a way that
took much longer for citeproc to parse. This version of pandoc is
built with citeproc 0.11, which fixes the performance regression.

One new feature (added by Albert Krewinkel) is that the Org reader now
parses parameter lists on unknown blocks, and also supports dynamic
blocks.

Thanks to all who contributed, especially new contributors
Emmanuel Ferdman, FoxChillz, mourino, and priiduonu.



==============================================================================
Subject: ANN: pandoc 3.8.3
From:    John G Macfarlane
Date:    Dec 1, 2025, 11:28:22 AM
Link:    https://groups.google.com/g/pandoc-announce/c/XuC4UT1Vjbo
==============================================================================

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.



==============================================================================
Subject: ANN: pandoc 3.9
From:    John G Macfarlane
Date:    Feb 4, 2026, 9:58:25 AM
Link:    https://groups.google.com/g/pandoc-announce/c/znue-42hMeI
==============================================================================

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

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

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

Starting with this release, pandoc can be compiled to WASM, making it
possible to use pandoc in the browser. A full-featured GUI interface
is provided at https://pandoc.org/app.

Defaults files may now be in either JSON or YAML, and variable
interpolation works now for the `defaults` field of a defaults file,
making it easier for defaults files to extend others.

--extract-media will now create a zip archive containing the media
(instead of a directory) if the specified path has a .zip extension.

A special class on headings can now be used to reset 'subsequent'
status for citations processed using --citeproc. This can be important
for some styles, which require that full citation information be given
for the first citation to a work in any given chapter.

The 'alerts' extension can now be used with pandoc's Markdown.

Support has been added for PDF standards and tagging via lualatex.

API changes:

- Text.Pandoc.Shared exports hasLineBreaks.
- The PandocHttpError constructor for PandocError now takes
a Text as argument instead of HttpException.

Thanks to all who contributed, especially new contributors Albert
Lei, Anton Melnikov, Chris Callison-Burch, Jacob Larkin, Yann
Trividic, You Jiangbin, benniekiss, and har7an.



==============================================================================
Subject: ANN: pandoc 3.9.0.1
From:    John G Macfarlane
Date:    Mar 18, 2026, 4:32:15 PM
Link:    https://groups.google.com/g/pandoc-announce/c/L2spx_he8Xo
==============================================================================

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

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

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

This is a bug-fix release, with no major new features or
API changes, but lots of small improvements. See the
changelog for details.

Thanks to all who contributed, especially new contributors
Agriya Khetarpal, Peter Briggs, Sidney Mau, and λx.x.



==============================================================================
Subject: ANN: pandoc 3.9.0.2
From:    John G Macfarlane
Date:    Mar 19, 2026, 1:55:13 PM
Link:    https://groups.google.com/g/pandoc-announce/c/5JEeRzqV7y8
==============================================================================

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

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

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

This release just fixes a bad regression in the typst template.



==============================================================================
Subject: ANN: pandoc 3.10
From:    John G Macfarlane
Date:    Jun 4, 2026, 6:33:30 PM
Link:    https://groups.google.com/g/pandoc-announce/c/qqYDHSVnaMg
==============================================================================

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.



==============================================================================
Subject: ANN: pandoc 3.10.1
From:    John G Macfarlane
Date:    Jul 22, 2026, 7:35:48 PM
Link:    https://groups.google.com/g/pandoc-announce/c/kqgKHaeHDNg
==============================================================================

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.

