Changelog for pandoc-2.11 | Hackage (2024)

 pandoc.system.with_temporary_directory('tikz', function (dir) -- write and compile a TikZ file with pdflatex end)

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%; }

pandoc 2.7.2 (2019-04-05)

• Add XWiki writer (#1800, Derek Chen-Becker).Add Text.Pandoc.Writers.XWiki, exporting writeXWiki [API change].

• Dokuwiki Reader: parse single curly brace (#5416, Mauro Bieg).

• Vimwiki reader: improve handling of internal links (#5414).We no longer append .html to link targets, and we add a titlewikilink. This mirrors behavior of other wiki readers. Generallythe .html extension is not wanted. It may be important for outputto HTML in certain circ*mstances, but it can always be added using afilter that matches on links with title wikilink.

  If your workflow requires the current behavior, here is a lua filterthat will add the .html extension:

  function Link(el) if el.title == 'wikilink' then el.target = el.target .. ".html" end return elend

• ipynb reader:

  • Use format ipynb for raw cell where no format given.
  • Avoid introducing spurious .0 on integers in metadata.

• Markdown reader: fenced div takes priority over setext header.

• HTML reader: read data-foo attribute into foo (#5392).The HTML writer adds the data- prefix for HTML5 for nonstandardattributes. But the attributes are represented in the AST withoutthe data- prefix, so we should strip this when reading HTML.

• LaTeX reader: Improve autolink detection (#5340).

• PowerPoint writer (Jesse Rosenthal):

  • Expand builtin reference doc to model all layouts.The previous built-in reference doc had only title and contentlayouts. Add in a section-header slide and a two-content slide, sousers can more easily modify it to build their own templates.
  • Always open up in slide view. When editing atemplate/reference-doc, the user might be in Master view, but whenproducing a slide show, it is assumed that slide view will bedesired.
  • Remove handoutsMasterList from template presentation.xml
  • Fix numerous errors in templating (#5402). Previously, some templatesproduced by Office 365 (MacOS) would not render with --reference-doccorrectly. We now apply correct shapes for content, and buildshape trees correctly.
  • Make default placeholder type for template lookup.
  • Apply speaker notes to metadata slide if applicable.
  • Test for speaker notes after breaking header.
  • Correctly handle notes after section-title header.Previously, if notes came after a section-title header (ie, a level-1header in a slide-level=2 presentation), they would go on the nextslide. This keeps them on the slide with the header.
  • Internal improvements.

• ipynb writer:

  • Use format ipynb for raw cell where no format given.According to nbformat docs, this is supposed to render in everyformat. We don't do that, but we at least preserve it as a rawblock in markdown, so you can round-trip.
  • Consolidate adjacent raw blocks. Sometimes pandoc creates twoHTML blocks, e.g. one for the open tag and one for a close tag.If these aren't consolidated, only one will show up in output cell.
  • Fixed carry-over of nbformat from metadata.
  • Preserve nbformat_minor if it's given. This helps with round-tripping.

• LaTeX writer:

  • Avoid inadvertently creating ? or ! ligatures (#5407).These are upside down ? and !, resp.
  • Fix footnotes in table caption and cells (#5367). This fixes abug wherein footnotes appeared in the wrong order, and withduplicate numbers, when in table captions and cells.We now use regular \footnote commands, even in the tablecaption and the minipages containing cells. Apparentlylongtable knows how to handle this.

• HTML writer: Don't add data- prefix to RDFa attributes (#5403).

• JATS writer: Ensure that plain strings go inside <pub-id> tag (#5397).

• Markdown writer:

  • Better rendering of numbers (#5398). If the number is integral,we render it as an integral not a float.
  • Proper rendering of empty map in YAML metadata (#5398). Shouldbe {}, not empty string.
  • Properly escape attributes in Markdown writer (#5369).
  • Be sure implicit figures work in list contexts (#5368).Previously they would sometimes not work: e.g., when theyoccurred in final paragraphs in lists that were originallyparsed as Plain and converted later using PlainToPara.

• Docx writer: Use w:br without attributes for line breaks (#5377).We previously added the attribute type="textWrapping", butthis causes problems on Word Online.

• LaTeX template (Andrew Dunning):

  • Ensure correct heading/table order (#5365). Improve workaround(#1658) for tables following headings. The new solution works whetheror not the indent variable is enabled.
  • Remove subparagraph variable. The default is now to use run-instyle for level 4 and 5 headings (\paragraph and \subparagraph).To get the previous default behavior (where these were formatted asblocks, like \subsubsection), set the block-headings variable.
  • Add pandoc to PDF metadata (#5388).
  • Group graphics-related code (#5389).
  • Move \setstretch after front matter (#5179). Ensures that\maketitle, \tableofcontents, and so forth are not affected bychanges to line spacing.

• Update data/jats.csl to avoid commas between name-part elements(#5397).

• Add support for golang (go) with --listings (#5427).

• Text.Pandoc.Shared - improve metaToJSON behavior with numbers.We now do a better job marshalling numbers from MetaStringor MetaInlines into JSON Number.

• Text.Pandoc.Writers.Shared: metaValueToJSON: use Number Values forintegers. Pandoc's MetaValue doesn't have a distinguished number type,so numbers are put in MetaStrings. If the MetaString consistsentirely of digits, we convert it to a Number. We should probablyconsider adding a MetaNumber constructor to MetaValue, for betterround-tripping with JSON etc. This change aids round-tripping inipynb metadata fields, like toc_depth.

• Text.Pandoc.Class: fetchItem: don't treat UNC paths asprotocol-relative URLs (#5127). These are paths beginning //?/UNC/....

• Text.Pandoc.ImageSize: Improve pdfSize so it handlesa wider range of PDFs (#4322, with help from Richard Davis).

• Text.Pandoc.Pretty: avoid stack overflow by using strict sum (#5401).

• Fix harmless error in file-scope code (#5422).

• MANUAL.txt:

  • Improve 'header' and 'heading' usage (#5423, AndrewDunning). The term 'header' was being used where 'heading'is more appropriate.
  • Add paragraph on options affecting markdown in ipynb.

• stack.yaml - remove -Wmissing-home-modulesThis seems to cause problems with stack ghci. Remove RTS options.

• Add ghc-options to cabal.project.

• appveyor.yml - use ghc 8.6.4. Fixes segfault issues on Windows (#5037).

• linux build process: Remove clone of pandoc-citeproc (#5366).It wasn't being used; cabal.project specifies the version to use.

pandoc 2.7.1 (2019-03-14)

• Add tectonic as an option for --pdf-engine (#5345, Cormac Relf).Runs tectonic on STDIN instead of a temporary .tex file, so that itlooks in the working directory for \include and \input like the restof the engines. Allows overriding the output directoryargs with --pdf-engine-opt=--outdir --pdf-engine-opt="$DIR".

• Allow -o/--output to be used with --print-default-data-file,--print-highlighting-style, --print-default-template.Note that -o must occur BEFORE the --print* command on the commandline (this is documented, #5357).

• LaTeX reader:

  • Support \underline, \ul, \uline (#5359, PaulTilley). These are parsed as a Span with class underline, aswith other readers.
  • Ensure that \Footcite and \Footcites get put in a note.

• ipynb reader:

  • Remove sensitivity to raw_html, raw_tex extensions.We now include every output format. Pruning is handled by--ipynb-output.
  • Better handling of cell metadata. We now include even complex cellmetadata in the Div's attributes (as JSON, in complex cases, oras plain strings in simple cases).

• ipynb writer:

  • Recurse into native divs for output cell data (#5354).
  • Render cell metadata fields from div attributes.

• Docx writer: avoid extra copy of abstractNum and num elementsin numbering.xml. This caused pandoc-produced docx files tobe uneditable using Word Online (#5358).

• Markdown writer: improve handling of raw blocks/inline.We now emit raw content using raw_attribute when no moredirect method is available. Use of raw_attribute can beforced by disabling raw_html and raw_tex.

• LaTeX writer: Add classes for frontmatter support (#5353, Andrew Dunning)and remove frontmatter from scrreprt.

• LaTeX template:

  • Improve readability (#5363, Andrew Dunning).
  • Robust section numbering removal (#5351, Andrew Dunning).Ensures that section numbering does not reappear with customsection levels. See https://tex.stackexchange.com/questions/473653/.
  • Better handling of front/main/backmatter (#5348).In pandoc 2.7 we assumed that every class with chapters would accept\frontmatter, \mainmatter, and \backmatter. This is not so (e.g.report does not). So pandoc 2.7 breaks on report class by including anunsupported command. Instead of the book-class variable, we use twovariables, has-chapters and has-frontmatter, and set theseintelligently in the writer.

• Text.Pandoc.Shared: Improve filterIpynbOutput. Ensure thatimages are prioritized over text. best should include everythingfor ipynb.

• Tests.Old: specify --data-dir=../data to ensure tests can finddata files even if they haven't been installed. Remove oldpandoc_datadir environment variable, which hasn't done anything for along time.

• MANUAL.txt: Add recommendation to use raw_attribute with ipynb (#5354).

• Use cmark-gfm-hs 0.1.8 (note that 0.1.7 is buggy).

• Use latest pandoc-citeproc, texmath.

pandoc 2.7 (2019-03-03)

• Use XDG data directory for user data directory (#3582). Instead of$HOME/.pandoc, the default user data directory is now$XDG_DATA_HOME/pandoc, where XDG_DATA_HOME defaults to$HOME/.local/share but can be overridden by setting theenvironment variable. If this directory is missing, then$HOME/.pandoc is searched instead, for backwards compatibility.However, we recommend moving local pandoc data files from$HOME/.pandoc to $HOME/.local/share/pandoc. On Windows thedefault user data directory remains the same.

• Slide show formats behavior change: content under headersless than slide level is no longer ignored, but included inthe title slide (for HTML slide shows) or in a slide afterthe title slide (for beamer). This change makes possible2D reveal.js slideshows with content in the top slide oneach stack (#4317, #5237).

• Add command line option --ipynb-output=all|none|best (#5339).Output cells in ipynb notebooks often contain several differentversions of an output, with different MIME types, e.g. an HTMLtable and a plain-text fallback. Specifying --ipynb-output=best(the default) ensures that the best version for the output formatis used. all includes all versions, and none suppresses themall, 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).

• Add latexmk as an option for --pdf-engine (#3195).Note that you can use --pdf-engine-opt=-outdir=bar to specifya persistent temp directory.

• Markdown reader:

  • Improve tight/loose list handling (#5285). Previously thealgorithm allowed list items with a mix of Para and Plain, whichis never wanted.
  • Add newline when parsing blocks in YAML (#5271). Otherwise lastblock gets parsed as a Plain rather than a Para. This is aregression in pandoc 2.x. This patch restores pandoc 1.19behavior.
  • Make yamlToMeta respect extensions (#5272, Mauro Bieg).This adds a ReaderOptions parameter to yamlToMeta [API change].
  • Fix bug parsing fenced code blocks (#5304). Previously parsingwould break if the code block contained a string of backticks ofsufficient length followed by something other than end of line.

• LaTeX reader: don't let \egroup match {. braced now actuallyrequires nested braces. Otherwise some legitimate command andenvironment definitions can break.

• Docx reader (Jesse Rosenthal):

  • Rename getDocumentPath as getDocumentXmlPath.
  • Use field notation for setting ReaderEnv.
  • Figure out document.xml path once at the beginning of parsing, andadd it to the environment, so we can avoid repeated lookups.
  • Dynamically determine main document xml path (#5277).The desktop Word program places the main document file inword/document.xml, but the online word places it inword/document2.xml. This file path is actually stated in the root_rels/.rels file, in the Relationship element with anhttp://../officedocument type.
  • Fix paths in archive to prevent Windows failure (#5277).Some paths in archives are absolute (have an opening slash) which, forreasons unknown, produces a failure in the test suite on MSWindows. This fixes that by removing the leading slash if it exists.
  • Add comments to aid code readability.
  • Trim space inside the last inline (#5273).
  • Unwrap sdt elements in footnotes and comments (#5302).

• Muse reader (Alexander Krotov):

  • Test that block level markup does not break <verbatim>.
  • Add secondary note support.

• ipynb reader: handle images referring to attachments. Previouslywe didn't strip off the attachment: prefix, so even though theattachment was available in the mediabag, pandoc couldn't find it.

• JATS reader:

  • Fix parsing of figures (#5321). This ensures that a figurecontaining a single image is parsed as a pandoc "implicitfigure" (i.e., a Para with a single Image whose title attributebegins with fig:). More complex figures will still be parsedas divs.
  • Support fig-group block element (#5317).
  • Handle citations with multiple references (#5310). The ridattribute can have a space-separated list of ids.

• AsciiDoc Writer: Add writeAsciiDoctor [API change, Tarik Graba].Handle display math appropriately for Asciidoctor.

• JATS writer: wrap figure caption in <p> to fix validation (#5290,Mauro Bieg).

• HTML writer:

  • Implement WAI-ARIA roles for (end)notes, citations, andbibliography (#4213). Note that doc-biblioref is only used whenlink-citations produces links, since it belongs on links.
  • Include content (including speaker notes) in title slides(#4317, #5237).

• ipynb writer:

  • Ensure final newline.
  • Only include metadata under jupyter field.
  • Don't create attachments for images with absolute URIs,including data: URIs (#5303).
  • Keep plain text fallbacks in output even if a richer format isincluded (#5293). We don't know what output format will be needed.See the --ipynb-output command line option for a way to controlwhat formats are included in the output.

• Markdown writer: use markdown="1" when appropriate for Divs:when native_divs and markdown_in_html_blocks are disabledbut raw_html and markdown_attribute are enabled.

• LaTeX writer:

  • Use right fold for escapeString. This is more elegant thanthe explicit recursive code we were using.
  • Avoid {} after control sequences when escaping.\ldots{}. doesn't behave as well as \ldots. with the latexellipsis package. This patch causes pandoc to avoid emittingthe {} when it is not necessary. Now \ldots and othercontrol sequences used in escaping will be followed by eithera {}, a space, or nothing, depending on context.
  • For beamer, include contents under headers superordinate toslidelevel (#4317). Currently we keep the fancy title slide, andadd a new slide with the same title and whatever content wasunder the header.

• Powerpoint writer (Jesse Rosenthal): support underlines.Use span with single class "underline" as in docx writer.

• Muse writer: escape secondary notes (Alexander Krotov).

• FB2 writer: add section identifiers support (#5229, John KetzerX).

• Make --fail-if-warnings work for PDF output (#5343).

• Lua filters (Albert Krewinkel):

  • Load module pandoc before calling init.lua (#5287). The fileinit.lua in pandoc's data directory is run as part of pandoc'sLua initialization process. Previously, the pandoc module wasloaded in init.lua, and the structure for marshaling wasset up after. This allowed simple patching of elementmarshaling, but made using init.lua more difficult. Now, allrequired modules are now loaded before calling init.lua. Thefile can be used entirely for user customization. Patchingmarshaling functions, while discouraged, is still possible viathe debug module.
  • All Lua modules bundled with pandoc, i.e., pandoc.List,pandoc.mediabag, pandoc.utils, and text are re-exported from thepandoc module. They are assigned to the fields List, mediabag,utils, and text, respectively.

• Text.Pandoc.Lua (Albert Krewinkel):

  • Split StackInstances into smaller Marshaling modules.
  • Get CommonState from Lua global. This allows more control overthe common state from within Lua scripts.

• LaTeX template:

  • Support the subject metadata variable (#5289, Pascal Wagler).
  • Add \frontmatter, \mainmatter, \backmatterfor book classes (#5306).

• epub3 template: Add titlepage class to section (#5269).

• HTML5 template: Add ARIA role doc-toc for table of contents (#4213).

• Make --metadata-file use selected extensions (#5279, #5272, Mauro Bieg).

• Text.Pandoc.Shared:

  • Remove withTempDir [API change].
  • Add new exported function defaultUserDataDirs [API change].
  • Add filterIpynbOutput [API change].
  • compactify: Avoid lists with a mix of Plain and Para elements(#5285).

• Text.Pandoc.Translations: reorder alphabetically and remove Author(#5334, Mauro Bieg).

• Text.Pandoc.Extensions:

  • More carefully groom ipynb default extensions.
  • Add all_symbols_escapable to githubMarkdownExtensions.

• Text.Pandoc.PDF:

  • Use system temp directory when possible (#1192). Previously wecreated temp dirs in the working directory, partly (a) becausethere were problems using the system temp directory on Windows,when their pathnames included tildes, and partly (b) becauseprograms like epstopdf.pl would not be allowed to write todirectories outside the working directory in restricted mode. Wenow (a) use the system temp dir except when the path includestildes, and (b) set TEXMFOUTPUT when creating the PDF, so thatsubsidiary programs can use the system temp directory. Thisaddresses problems that occurred when pandoc was used in asynced directory (such as Dropbox).
  • Change types of subsidiary functions to PandocIO, to allowwarnings to be threaded through (#5343).

• Text.Pandoc.MIME: add WebP (#5267, Mauro Bieg).

• Tests: avoid calling findPandoc multiple times.

• Old tests: remove need for temp files by using pipeProcess.

• Added simple ipynb reader/writer tests (#5274).

• Rearrange --help output in a more rational way, with commonoptions at the beginning and options grouped by function (#5336).

• trypandoc: Add JATS and other missing formats (Arfon Smith, #5291).

• Add missing copyright notices and remove license boilerplate (#4592,Albert Krewinkel).

• Use latest basem*nt/foundation on 32bit windows.

• Use latest skylighting (#5328). Custom syntax definitions nolonger try to load language.dtd.

• Require texmath 0.11.2.1

• Use latest pandoc-citeproc (0.16.1.1).

• MANUAL.txt:

  • Clarify variable substitution indentation in templates (#5338,Agustín Martín Barbero).
  • Reorder custom-styles section (#5324, Mauro Bieg).

pandoc 2.6 (2019-01-30)

• Support ipynb (Jupyter notebook) as input and output format.

  • Add ipynb as input and output format (extension .ipynb).
  • Added Text.Pandoc.Readers.Ipynb [API change].
  • Added Text.Pandoc.Writers.Ipynb [API change].
  • Add PandocIpynbDecodingError constructor to Text.Pandoc.Error.Error[API change].
  • Depend on ipynb library.
  • Note: there is no template for ipynb.

• Add DokuWiki reader (#1792, Alexander Krotov). This addsText.Pandoc.Readers.DokuWiki [API change], and adds dokuwikias an input format.

• Implement task lists (#3051, Mauro Bieg). Added task_listsextension. Task lists are supported from markdown and gfm input.They should work, to some degree, in all output formats, though inmost formats you'll get a bullet list with a unicode character forthe box. In HTML, you get checkboxes and in LaTeX/PDF output, abox is used as the list marker. API changes:

  • Added constructor Ext_task_lists to Extension.
  • Added taskListItemFromAscii and taskListItemToAscii toText.Pandoc.Shared.

• Allow some command line options to take URL in addition to FILE.--include-in-header, --include-before-body, --include-after-body.

• HTML reader:

  • Handle empty start attribute (see #5162).
  • Treat textarea as a verbatim environment (#5241) and preservespacing.

• RST reader:

  • Change treatment of number-lines directive (Brian Leung,#5207). Directives of this type without numeric inputs shouldnot have a startFrom attribute; with a blank value, thewriters can produce extra whitespace.
  • Removed superfluous sourceCode class on code blocks (#5047).
  • Handle sourcecode directive as synonynm for code (#5204).

• Markdown reader:

  • Remove sourceCode class for literate Haskell code blocks(#5047). Reverse order of literate and haskell classes oncode blocks when parsing literate Haskell, so haskell isfirst.
  • Treat <textarea> as a verbatim environment (#5241).

• Org reader:

  • Handle minlevel option differently (#5190, Brian Leung).When minlevel exceeds the original minimum level observed inthe file to be included, every heading should be shiftedrightward.
  • Allow for case of :minlevel == 0 (#5190).
  • Fix treatment of links to images (#5191, Albert Krewinkel).Links with descriptions which are pointing to images are nolonger parsed as inline images, but as links.
  • Add support for #+SELECT_TAGS (Brian Leung).
  • Separate filtering logic from conversion function (Brian Leung).

• TWiki reader: Fix performance issue with underscores (#3921).

• MediaWiki reader: use _ instead of - in auto-identifiers (#4731).We may not still be exactly matching mediawiki's algorithm.

• LaTeX reader:

  • Remove sourceCode class for literate Haskell code blocks(#5047). Reverse order of literate and haskell classes oncode blocks when parsing literate Haskell, so haskell isfirst.
  • Support \DeclareMathOperator (#5149).
  • Support \inputminted (#5103).
  • Support \endinput (#5233).
  • Allow includes with dots like cc_by_4.0. Previously the .0was interpreted as a file extension, leading pandoc not to add.tex (and thus not to find the file). The new behavior matchestex more closely.

• Man reader:

  • Use mapLeft from Shared instead of defining own.

• Docx reader (Jesse Rosenthal):

  • Handle level overrides (#5134).

• Docx writer:

  • Support custom properties (#3024, #5252, Agustín Martín Barbero).Also supports additional core properties: subject, lang,category, description.
  • Make Level into a real type, instead of an alias for a tuple(Jesse Rosenthal).

• ICML writer (Mauro Bieg):

  • Support custom-styles (#5137, see #2106).
  • Support unnumbered headers (#5140).

• Texinfo writer: Use header identifier for anchor if present (#4731).Previously we were overwriting an existing identifier with a new one.

• Org writer: Preserve line-numbering for example and code blocks(Brian Leung).

• Man/Ms writers: Don't escape - as \-. The \- gets renderedin HTML and PDF as a unicode minus sign.

• Ms writer: Ensure we have a newline after .EN in disply math (#5251).

• RST writer: Don't wrap simple table header lines (#5128).

• Asciidoc writer: Shorter delimiters for tables, blockquotes(#4364). This matches asciidoctor reference docs.

• Dokuwiki writer: Remove automatic : prefix before internal imagelinks (#5183, Damien Clochard). This prevented users from makingrelative image links.

• Zimwiki writer: remove automatic colon prefix before internalimages (#5183, Damien Clochard).

• MediaWiki writer: fix caption, use 'thumb' instead of 'frame'(#5105). Captions used to have the word 'caption' prepended; thishas been removed. Also, 'thumb' is used instead of 'frame' toallow images to be resized.

• reveal.js writer:

  • Ensure that we don't get > 2 levels of section nesting,even with slide level > 2 (#5168).
  • If slide level == N but there is no N-level header, makesure the next header with level > N gets treated as a slideand put in a section, rather than remaining loose (#5168).

• Markdown writer:

  • Make plain RawBlocks pass through in plain output.
  • Include needed whitespace after HTML figure (#5121).We use HTML for a figure in markdown dialects that can'trepresent it natively.

• Commonmark writer:

  • Fix handling of SoftBreak with hard_line_breaks (#5195).
  • Implement --toc (writerTableOfContents)in commonmark/gfm writers (#5172).

• EPUB writer:

  • Ensure that picture transforms are done on metadata too.
  • Small fixes to nav.xhtml:Add 'landmarks' id attribute to the landmarks nav.Replace old default CSS removing numbers from ol.toc liwith new rules that match nav#toc ol, nav#landmarks ol.We keep the toc class on ol for backwards compatibility.

• LaTeX writer:

  • Make raw content marked beamer pass through in beameroutput (pandoc/lua-filters#40).
  • Beamer: avoid duplicated fragile property in some cases(#5208).
  • Add # special characters for listings (#4939).This character needs special handling in \lstinline.

• RTF writer: use toTableOfContents from Shared to replaceold duplicated code.

• Pptx writer:

  • Support custom properties. Also supports additional coreproperties: subject, category, description (#5252,Agustín Martín Barbero).
  • Use toTableOfContents from Shared to replace old duplicated code.

• ODT writer (Augustín Martín Barbero):

  • Fix typo in custom properties (#2839).
  • Improve standard properties, including the following coreproperties: generator (Pandoc/VERSION), description, subject,keywords, initial-creator (from authors), creation-date(actual creation date) (#5252).

• Custom writers:

  • Allow '-' in filenames for custom lua writers (#5187).
  • sample.lua: add SingleQuoted, DoubleQuoted (#5104).
  • sample.lua: Add a missing > (MichaWiedenmann).

• reveal.js template: Add zoomKey config (#4249).

• HTML5 template: Remove unnecessary type="text/css" on style andlink for HTML5 (#5146).

• LaTeX template (Andrew Dunning, except where noted):

  • Prevent fontspec from scaling mainfont to match the defaultfont, Latin Modern. A main font set to 12pt couldpreviously appear between 11pt to 13pt depending on its design.To return to the earlier rendering, use -V mainfontoptions="Scale=MatchLowercase" (#5212, #5218).
  • Display monospaced fonts without TeX ligatures when using--pdf-engine=lualatex. It now matches the behaviour of otherengines (#5212, #5218).
  • Remove the deprecated romanfont variable. The functionality ofmainfont is identical (#5218).
  • Render \subtitle with the standard document classes.Previously, subtitle only appeared when using the KOMA-Scriptclasses or Beamer (#5213, #5244).
  • Use Babel instead of Polyglossia for LuaLaTeX. This avoidsseveral language selection problems, notably with retainingFrench spacing conventions when switching to a verbatimenvironment or another language; and in printing Greek textwithout hyphenation (#5193).
  • Use the xurl package ifavailable, improving the appearance of URLs by allowing them tobreak at additional points (#5193).
  • Use bookmark if availableto correct heading levels in PDF bookmarks: see the KOMA-Script3.26 release notes (#5193).
  • Require the xcolor package toavoid a possible error when using additional packages alongsidefootnotes in tables (#5193, closes #4861).
  • Remove obsolete fixltx2e package, which has no functionalitywith TeX Live 2015 or later (#5193).
  • Allow multiple fontfamilies.options (#5193, closes #5194).
  • Restrict institute variable to Beamer (#5219).
  • Use footnotehyperpackage if available to make footnotes in tables compatiblewith hyperref (#5234).
  • Number parts and chapters in book classes only if thenumbersections variable is set, for consistency with otheroutput formats. To return to the previous behaviour, use-V numbersections -V secnumdepth=0 (#5235).
  • Reindent file (#5193).
  • Use built-in parskip handling with KOMA-Script classes (#5143, Enno).
  • Set default listings language for lua, assembler (#5227, JohnMacFarlane). Otherwise we get an error when trying to compile codewith lua or assembler code. To change the default dialect(currenty 5.3 for lua and x86masm for assembler), you can use--include-in-header to inject something like\lstset{defaultdialect=[5.2]Lua}.

• Text.Pandoc.Readers: Changed types of readJSON; it now runsin an instance of PandocMonad, like the other readers andwriters. [API change]

• Text.Pandoc.Writers: Changed types of writeJSON; it now runsin an instance of PandocMonad, like the other readers andwriters. [API change]

• Text.Pandoc.Error: Added PandocUTF8DecodingError constructorfor PandocError. [API change]

• Text.Pandoc.Writers.Shared - add toTableOfContents. [API change]This is refactored out from the Markdown writer.It can be used in other writers to create a table of contents.

• Improve error messages for UTF-8 decoding errors. Now we givethe filename and byte offset (#4765).

• Text.Pandoc.XML: Strip out illegal XML characters inescapeXMLString (#5119).

• Text.Pandoc.Process: update pipeProcess (Albert Krewinkel).The implementation of pipeProcess was rewritten to fix sporadicfailures caused by prematurely closed pipes.

• Use safeRead instead of read everywhere in the code(John MacFarlane, Mauro Bieg, #5162, #5180).

• Text.Pandoc.SelfContained: Decompress .svgz whenconverting to data: URI (#5163, Alexander Krotov).

• Text.Pandoc.Parsing: Remove unused HasHeaderMap(#5175, Alexander Krotov). [API change]

• Normalize Windows paths to account for change in ghc 8.6 (#5127).When pandoc is compiled with ghc 8.6, Windows paths are treateddifferently, and paths beginning \\server no longer work.This commit rewrites such patsh to \\?\UNC\server which works.The change operates at the level of argument parsing, so itonly affects the command line program.

• Simplify/fix reading of --metadata values on command lineto avoid problems relating to hvr/HsYAML#7 (#5177).

• data/pandoc.lua: auto-fix nested constructor arguments (AlbertKrewinkel). Incorrect types to pandoc element constructors areautomatically converted to the correct types when possible. This wasalready done for most constructors, but conversions are now also donefor nested types (like lists of lists).

• Removed custom Setup.hs, use build-type: simple. The only thing wegained from the custom build was automatic installation of the manpage when using 'cabal install'. But custom builds cause problems,e.g., with cross-compilation. Installation of the man page isbetter handled by packagers. Note to packagers (e.g. Debian): itmay be necessary to add a step installing the man page with thenext release.

• Allow latest http-client, tasty, zip-archive, Glob.

• Require skylighting >= 0.7.5, adding support for sml, J,typescript.

• Tests: Cleaned up findPandoc in Tests.Helpers, so itworks well with cabal v2.

• INSTALL.md:

  • Use button for installer links (John MacFarlane, Mauro Bieg,#5167).
  • Fix links and bump required stack version (max).
  • Improve installation notes on associated software (AndrewDunning). Includes explanation of how to install related toolswith package managers (since the method of installingrsvg-convert is not obvious).

• doc/org.md: improve documentation of org features (AlbertKrewinkel).

• doc/lua-filters.md: use 3rd level headers for module fields.

• MANUAL:

  • Clarify automatic identifiers (#5201). We removenon-alphanumerics. This includes, e.g., emojis.
  • Fix example for Div with id (Geoffrey Ely).
  • Update list of LaTeX packages used.
  • Make it clear that hard_line_breaks works in gfm (see #5195).
  • Mention raw_attribute in documentation for raw_html andraw_tex (#5240, thanks to @eiro).
  • Clarify that $sep$ must come right before $endfor$ in templates(#5243, Lev Givon).
  • Document metadata support for docx, odt, pptx writers (AgustínMartín Barbero).
  • Reorganize template variables (#5249, Andrew Dunning).Add additional headings to categorize variables, andalphabetize when there is large number; add more examples.
  • Document date-meta template variable (#5260, Tristan Stenner).

• trypandoc: Fix CSS and viewport.

pandoc 2.5 (2018-11-27)

• Text.Pandoc.App: split into several unexported submodules (AlbertKrewinkel): Text.Pandoc.App.FormatHeuristics,Text.Pandoc.App.Opt, Text.Pandoc.App.CommandLineOptions,Text.Pandoc.App.OutputSettings. This is motivated partly by thedesire to reduce recompilations when something is modified,since App previously depended on virtually every other module.

• Text.Pandoc.Extensions

  • Semantically, gfm_auto_identifiers is now a modifier ofauto_identifiers; for identifiers to be set, auto_identifiers mustbe turned on, and then the type of identifier produced depends ongfm_auto_identifiers and ascii_identifiers are set. Accordingly,auto_identifiers is now added to githubMarkdownExtensions (#5057).
  • Remove ascii_identifiers from githubMarkdownExtensions.GitHub doesn't seem to strip non-ascii characters any more.

• Text.Pandoc.Lua.Module.Utils (Albert Krewinkel)

  • Test AST object equality via Haskell (#5092). Equality of Luaobjects representing pandoc AST elements is tested by unmarshallingthe objects and comparing the result in Haskell.A new function equals which performs this test has been added to thepandoc.utils module.
  • Improve stringify. Meta value strings (MetaString)and booleans (MetaBool) are now converted to the literal string and thelowercase boolean name, respectively. Previously, all values of thesetypes were converted to the empty string.

• Text.Pandoc.Parsing: Remove Functor and Applicative constraints where Monadalready exists (Alexander Krotov).

• Text.Pandoc.Pretty: Don't render BreakingSpace at end of lineor beginning of line (#5050).

• Text.Pandoc.Readers.Markdown

  • Fix parsing of citations, quotes, and underline emphasisafter symbols. Starting with pandoc 2.4, citations, quoted inlines,and underline emphasis were no longer recognized after certainsymbols, like parentheses (#5099, #5053).
  • In pandoc 2.4, a soft break after an abbreviation would berelocated before it to allow for insertion of a nonbreakingspace after the abbreviation. This behavior is here reverted.A soft break after an abbreviation will remain, and no nonbreakingspace will be added. Those who care about this issue should take care notto end lines with an abbreviation, or to insert nonbreaking spacesmanually.

• Text.Pandoc.Readers.FB2: Do not throw error for unknown elements in<body> (Alexander Krotov). Some libraries include custom elementsin their FB2 files.

• Text.Pandoc.Readers.HTML

  • Allow tfoot before body rows (#5079).
  • Parse <small> as a Span with class "small" (#5080).
  • Allow thead containing a row with td rather than th (#5014).

• Text.Pandoc.Readers.LaTeX

  • Cleaned up handling of dimension arguments. Allow decimal points,preceding space.
  • Don't allow arguments for verbatim, etc.
  • Allow space before bracketed options.
  • Allow optional arguments after \\ in tables.
  • Improve parsing of \tiny, \scriptsize, etc. Parse as raw,but know that these font changing commands take no arguments.

• Text.Pandoc.Readers.Muse

  • Trim whitespace before parsing grid table cells (Alexander Krotov).
  • Add grid tables support (Alexander Krotov).

• Text.Pandoc.Shared

  • For bibliography match Div with id refs, not class references.This was a mismatch between pandoc's docx, epub, latex, and markdownwriters and the behavior of pandoc-citeproc, which actually looks for adiv with id refs rather than one with class references.
  • Exactly match GitHub's identifier generating algorithm (#5057).
  • Add parameter for Extensions to uniqueIdent andinlineListToIdentifier (#5057). [API change]This allows these functions to be sensitive to the settings ofExt_gfm_auto_identifiers and Ext_ascii_identifiers, and allows us touse uniqueIdent in the CommonMark reader, replacing custom code. Italso means that gfm_auto_identifiers can now be used in all formats.

• Text.Pandoc.Writers.AsciiDoc

  • Use .+ as list markers to support nested ordered lists (#5087).
  • Support list number styles (#5089).
  • Render Spans using [#id .class]#contents# (#5080).

• Text.Pandoc.Writers.CommonMark

  • Respect --ascii (#5043, quasicomputational).
  • Make sure --ascii affects quotes, super/subscript.

• Text.Pandoc.Writers.Docx

  • Fix bookmarks to headers with long titles (#5091).Word has a 40 character limit for bookmark names. In addition, bookmarksmust begin with a letter. Since pandoc's auto-generated identifiers maynot respect these constraints, some internal links did not work. Withthis change, pandoc uses a bookmark name based on the SHA1 hash of theidentifier when the identifier isn't a legal bookmark name.
  • Add bookmarks to code blocks (Nikolay Yakimov).
  • Add bookmarks to images (Nikolay Yakimov).
  • Refactor common bookmark creation code into a function (Nikolay Yakimov).

• Text.Pandoc.Writers.EPUB: Handle calibre metadata (#5098).Nodes of the form

   <meta name="calibre:series" content="Classics on War and Politics"/>

  are now included from an epub XML metadata file. You can also includethis information in your YAML metadata, like so:

   calibre: series: Classics on War and Policitics

  In addition, ibooks-specific metadata can now be included via an XMLfile. (Previously, it could only be included via YAML metadata, see#2693.)

• Text.Pandoc.Writers.HTML: Use plain " instead of " outside ofattributes.

• Text.Pandoc.Writers.ICML: Consolidate adjacent strings, inc. spaces.This avoids splitting up the output unnecessarily into separate elements.

• Text.Pandoc.Writers.LaTeX: Don't emit [<+->] unless beamer output, evenif writerIncremental is True (#5072).

• Text.Pandoc.Writers.Muse (Alexander Krotov).

  • Output tables as grid tables if they have multi-line cells.
  • Indent simple tables only on the top level.
  • Output tables with one column as grid tables.
  • Add support for --reference-location.
  • Internal improvements.

• Text.Pandoc.Writers.OpenDocument: Fix list indentation (Nils Carlson,#5095). This was a regression in pandoc 2.4.

• Text.Pandoc.Writers.RTF: Fix warnings for skipped raw inlines.

• Text.Pandoc.Writers.Texinfo: Add blank line before @menu section (#5055).

• Text.Pandoc.XML: in toHtml5Entities, prefer shorter entitieswhen there are several choices for a particular character.

• data/abbreviations

  • Add additional abbreviations (Andrew Dunning)Many of these borrowed from the Chicago Manual of Style 10.42,'Scholarly abbreviations'.

• Templates

  • Asciidoc template: add :lang: to title header is lang is set inmetadata (#5088).

• pandoc.cabal: Add cabal flag derive_json_via_th (Albert Krewinkel)Disabling the flag will cause derivation of ToJSON and FromJSONinstances via GHC Generics instead of Template Haskell. The flag isenabled by default, as deriving via Generics can be slow (see #4083).

• trypandoc:

  • Tweaked drop-down lists.
  • Put link to site in footer.
  • Preselect output format.
  • Update on change of in or out format.
  • Add man input format.

• MANUAL.txt:

  • Fix outdated description of latex_macros extension.
  • Clarified placement of bibliography.
  • Added "A note on security."
  • Fix note on curly brace syntx for locators.
  • Document new explicit syntax for citeproc locators.
  • Remove confusing cross-links for some extensions.
  • Don't put pandoc in code ticks in heading.
  • Document that --ascii works for gfm and commonmark too.
  • Add man to --from options.

• doc/customizing-pandoc.md: various improvements (Mauro Bieg).

pandoc 2.4 (2018-11-03)

New features

• New input format man (Yan Pashkovsky, John MacFarlane).

Behavior changes

• --ascii is now implemented in the writers, not in Text.Pandoc.App,via the new writerPreferAscii field in WriterOptions.Now the write* functions for Docbook, HTML, ICML, JATS, LaTeX,Ms, Markdown, and OPML are sensitive to writerPreferAscii.Previously the to-ascii translation was done in Text.Pandoc.App,and thus not available to those using the writer functionsdirectly.

• --ascii now works with Markdown output. HTML5 character referenceentities are used.

• --ascii now works with LaTeX output. 100% ASCII output can't beguaranteed, but the writer will use commands like \"{a} and \lwhenever possible, to avoid emitting a non-ASCII character.

• For HTML5 output, --ascii now uses HTML5 character referenceentities rather than numerical entities.

• Improved detection of format based on extension (in Text.Pandoc.App).We now ensure that if someone tries to convert a file for aformat that has a pandoc writer but not a reader, it won't justdefault to markdown.

• Add viz. to abbreviations file (#5007, Nick Fleisher).

• AsciiDoc writer: always use single-line section headers,instead of the old underline style (#5038). Previously the single-linestyle would be used if --atx-headers was specified, butnow it is always used.

• RST writer: Use simple tables when possible (#4750).

• CommonMark (and gfm) writer: Add plain text fallbacks. (#4528,quasicomputational). Previously, the writer would unconditionallyemit HTML output for subscripts, superscripts, strikeouts (if thestrikeout extension is disabled) and small caps, even withraw_html disabled. Now there are plain-text (and, wherepossible, fancy Unicode) fallbacks for all of these corresponding(mostly) to the Markdown fallbacks, and the HTML output is onlyused when raw_html is enabled.

• Powerpoint writer: support raw openxml (Jesse Rosenthal, #4976).This allows raw openxml blocks and inlines to be used in the pptxwriter. Caveats: (1) It's up to the user to writewell-formed openxml. The chances for corruption, especially withsuch a brittle format as pptx, is high. (2) Because ofthe tricky way that blocks map onto shapes, if you are usinga raw block, it should be the only block on a slide(otherwise other text might end up overlapping it). (3) Thepptx ooxml namespace abbreviations are different from thedocx ooxml namespaces. Again, it's up to the user to get itright. Unzipped document and ooxml specification should beconsulted.

• With --katex in HTML formats, do not use the autorenderer (#4946).We no longer surround formulas with \(..\) or \[..\]. Instead,we tell katex to convert the contents of span elements withclass "math". Since math has already been identified, thisavoids wasted time parsing for LaTeX delimiters. Note, however,that this may yield unexpected results if you have span elementswith class "math" that don't contain LaTeX math.Also, use latest version of KaTeX by default (0.9.0).

• The man writer now produces ASCII-only output, using groff escapes,for portability.

• ODT writer:

  • Add title, author and date to metadata; any remainingmetadata fields are added as meta:user-defined tags.
  • Implement table caption numbering (#4949, Nils Carlson).Captioned tables are numbered and labeled with format "Table 1:caption", where "Table" is replaced by a translation, dependingon the value of lang in metadata. Uncaptioned tables are notenumerated.
  • OpenDocument writer: Implement figure numbering in captions (#4944,Nils Carlson). Figure captions are now numbered 1, 2, 3, ...The format in the caption is "Figure 1: caption" and so on(where "Figure" is replaced by a translation, depending on thevalue of lang in the metadata). Captioned figures are numberedconsecutively and uncaptioned figures are not enumerated. Thisis necessary in order for LibreOffice to generate anIllustration Index (Table of Figures) for included figures.

• RST reader: Pass through fields in unknown directives as div attributes(#4715). Support class and name attributes for all directives.

• Org reader: Add partial support for #+EXCLUDE_TAGS option. (#4284,Brian Leung). Headers with the corresponding tags should notappear in the output.

• Log warnings about missing title attributes now include asuggestion about how to fix the problem (#4909).

• Lua filter changes (Albert Krewinkel):

  • Report traceback when an error occurs. A proper Lua traceback isadded if either loading of a file or execution of a filterfunction fails. This should be of help to authors of Lua filterswho need to debug their code.

  • Allow access to pandoc state (#5015). Lua filters and customwriters now have read-only access to most fields of pandoc'sinternal state via the global variable PANDOC_STATE.

  • Push ListAttributes via constructor (Albert Krewinkel).This ensures that ListAttributes, as present in OrderedList elements,have additional accessors (viz. start, style, and delimiter).

  • Rename ReaderOptions fields, use snake_case. Snake case is usedin most variable names, using camelCase for these fields was anoversight. A metatable is added to ensure that the old fieldnames remain functional.

  • Iterate over AST element fields when using pairs. This makesit possible to iterate over all ield names of an AST element byusing a generic for loop with pairs`:

    for field_name, field_content in pairs(element) do...end

    Raw table fields of AST elements should be considered animplementation detail and might change in the future. Accessingelement properties should always happen through the fieldslisted in the Lua filter docs.

    Note that the iterator currently excludes the t/tag field.

  • Ensure that MetaList elements behave like Lists. Methods usableon Lists can also be used on MetaList objects.

  • Fix MetaList constructor (Albert Krewinkel). Passing a MetaListobject to the constructor pandoc.MetaList now returns thepassed list as a MetaList. This is consistent with theconstructor behavior when passed an (untagged) list.

• Custom writers: Custom writers have access to the global variablePANDOC_DOCUMENT(Albert Krewinkel, #4957). The variable containsa userdata wrapper around the full pandoc AST and exposes twofields, meta and blocks. The field content is onlymarshaled on-demand, performance of scripts not accessing thefields remains unaffected.

API changes

• Text.Pandoc.Options: add writerPreferAscii to WriterOptions.

• Text.Pandoc.Shared:

  • Export splitSentences. This was previously duplicated in the Man andMs writers.
  • Add ToString typeclass (Alexander Krotov).

• New exported module Text.Pandoc.Filter (Albert Krewinkel).

• Text.Pandoc.Parsing

  • Generalize gridTableWith to any Char Stream (Alexander Krotov).
  • Generalize readWithM from [Char] to any Char Streamthat is a ToString instance (Alexander Krotov).

• New exposed module Text.Pandoc.Filter (Albert Krewinkel).

• Text.Pandoc.XML: add toHtml5Entities.

• New exported module Text.Pandoc.Readers.Man (Yan Pashkovsky, JohnMacFarlane).

• Text.Pandoc.Writers.Shared

  • Add exported functions toSuperscript andtoSubscript (quasicomputational, #4528).
  • Remove exported functions metaValueToInlines,metaValueToString. Add new exported functionslookupMetaBool, lookupMetaBlocks, lookupMetaInlines,lookupMetaString. Use these whenever possible for uniformityin writers (Mauro Bieg, #4907). (Note thatremoved function metaValueToInlines was in previousreleased versions.)
  • Add metaValueToString.

• Text.Pandoc.Lua

  • Expose more useful internals (Albert Krewinkel):

    • runFilterFile to run a Lua filter from file;
    • data type Global and its constructors; and
    • setGlobals to add globals to a Lua environment.

    This module also contains Pushable and Peekable instancesrequired to get pandoc's data types to and from Lua. Low-levelLua operation remain hidden in Text.Pandoc.Lua.

  • Rename runPandocLua to runLua (Albert Krewinkel).

  • Remove runLuaFilter, merging this into Text.Pandoc.Filter.Lua'sapply (Albert Krewinkel).

Bug fixes and under-the-hood improvements

• Text.Pandoc.Parsing

  • Make uri accept any stream with Char tokens (Alexander Krotov).
  • Rewrite uri without withRaw (Alexander Krotov).
  • Generalize parseFromString and parseFromString' to anystreams with Char token (Alexander Krotov)
  • Rewrite nonspaceChar using noneOf (Alexander Krotov)

• Text.Pandoc.Shared: Reimplement mapLeft using Bifunctor.first(Alexander Krotov).

• Text.Pandoc.Pretty: Simplify Text.Pandoc.Pretty.offset(Alexander Krotov).

• Text.Pandoc.App

  • Work around HXT limitation for --syntax-definition with windowsdrive (#4836).
  • Always preserve tabs for man format. We need it for tables.
  • Split command line parsing code into a separate unexportedmodule, Text.Pandoc.App.CommandLineOptions (Albert Krewinkel).

• Text.Pandoc.Readers.Roff: new unexported module for tokenizingroff documents.

• New unexported module Text.Pandoc.RoffChar, provided characterescape tables for roff formats.

• Text.Pandoc.Readers.HTML: Fix htmlTag and isInlineTag toaccept processing instructions (#3123, regression since 2.0).

• Text.Pandoc.Readers.JATS: Use foldl' instead of maximum toaccount for empty lists (Alexander Krotov).

• Text.Pandoc.Readers.RST: Don't allow single-dash separator inheaderless table (#4382).

• Text.Pandoc.Readers.Org: Parse empty argument array in inline srcblocks (Brian Leung).

• Text.Pandoc.Readers.Vimwiki:

  • Get rid of F, runF and stateMeta' in favor of stateMeta(Alexander Krotov).
  • Parse Text without converting to [Char] (Alexander Krotov).

• Text.Pandoc.Readers.Creole: Parse Text without converting to[Char] (Alexander Krotov).

• Text.Pandoc.Readers.LaTeX

  • Allow space at end of math after \ (#5010).
  • Add support for nolinkurl command (#4992, Brian Leung).
  • Simplified type on doMacros'.
  • Tokenize before pulling tokens, rather than after (#4408). Thishas some performance penalty but is more reliable.
  • Make macroDef polymorphic and allow in inline context.Otherwise we can't parse something like \lowercase{\def\x{Foo}}.I have actually seen tex like this in the wild.
  • Improved parsing of \def, \let. We now correctly parse:

    \def\bar{hello}\let\fooi\bar\def\fooii{\bar}\fooi +\fooii\def\bar{goodbye}\fooi +\fooii

  • Improve parsing of \def argspec.
  • Skip \PackageError commands (see #4408).
  • Fix bugs omitting raw tex (#4527). The default is -raw_tex,so no raw tex should result unless we explicitly say +raw_tex.Previously some raw commands did make it through.
  • Moved isArgTok to Text.Pandoc.Readers.LaTeX.Parsing.
  • Moved babelLangToBCP, polyglossiaLangToBCP to new module,Text.Pandoc.Readers.LaTeX.Lang (unexported).
  • Simplified accent code using unicode-transforms.New dependency on unicode-transforms package for normalization.
  • Allow verbatim blocks ending with blank lines (#4624).
  • Support breq math environments: dmath, dgroup, darray.This collects some of the general-purpose code from the LaTeX reader,with the aim of making the module smaller.

• Text.Pandoc.Readers.Markdown

  • Fix awkward soft break movements before abbreviations (#4635).
  • Add updateStrPos in a couple places where needed.

• Text.Pandoc.Readers.Docx: Trigger bold/italic with bCs, iCs(#4947). These are variants for "complex scripts" like Arabicand are now treated just like b, i (bold, italic).

• Text.Pandoc.Readers.Muse (Alexander Krotov)

  • Try to parse lists before trying to parse table.This ensures that tables inside lists are parsed correctly.
  • Forbid whitespace after opening and before closing markupelements.
  • Parse page breaks.
  • Simplify museToPandocTable to get rid of partial functions.
  • Allow footnotes to start with empty line.
  • Make sure that the whole text is parsed.
  • Allow empty headers. Previously empty headers caused parser toterminate without parsing the rest of the document.
  • Allow examples to be indented with tabs.
  • Remove indentation from examples indicated by {{{ and }}}.
  • Fix parsing of empty cells.
  • Various changes to internals.
  • Rewrite some parsers in applicative style.
  • Avoid tagsoup dependency.
  • Allow table caption to contain +.

• Text.Pandoc.Writers.LaTeX

  • Add newline if math ends in a comment (#4880). This prevents theclosing delimiter from being swalled up in the comment.
  • With --listings, don't pass through org-babel attributes (#4889).
  • With --biblatex, use \autocite when possible (#4960).\autocites{a1}{a2}{a3} will not collapse the entries. So, ifwe don't have prefixes and suffixes, we use instead\autocite{a1,a2,a3}.
  • Fix description lists contining highlighted code (#4662).

• Text.Pandoc.Writers.Man

  • Don't wrap .SH and .SS lines (#5019).
  • Avoid unnecessary .RS/.RE pair in definition lists withone paragraph definitions.
  • Moved common groff functions to Text.Pandoc.Writers.Groff.
  • Fix strong/code combination on man (should be \f[CB] not\f[BC], see #4973).
  • Man writer: use \f[R] instead of \f[] to reset font(Alexander Krotov, #4973).
  • Move splitSentences to Text.Pandoc.Shared.

• Text.Pandoc.Writers.Docx

  • Add framework for custom properties (#3034). So far, we don'tactually write any custom properties, but we have theinfrastructure to add this.

  • Handle tables in table cells (#4953). Although this is notdocumented in the spec, some versions of Word require a w:pelement inside every table cell. Thus, we add one when thecontents of a cell do not already include one (e.g. when a tablecell contains a table).

• Text.Pandoc.Writers.AsciiDoc: Prevent illegal nestings.Adjust header levels so that n+1 level headers are onlyfound under n level headers, and the top level is 1.

• Text.Pandoc.Writers.OpenDocument: Improve bullet/numberingalignment (#4385). This change eliminates the large gap we usedto have between bullet and text, and also ensures that numbersin numbered lists will be right-aligned.

• Text.Pandoc.Writers.ZimWiki

  • Number ordered list items sequentially, rather than alwayswith 1 (#4962).
  • Remove extra indentation on lists (#4963).

• Text.Pandoc.Writers.EPUB: Use metadata field css instead ofstylesheet (Mauro Bieg, #4990).

• Text.Pandoc.Writers.Markdown: Ensure blank between raw block andnormal content (#4629). Otherwise a raw block can prevent aparagraph from being recognized as such.

• Text.Pandoc.Writers.Ms

  • Removed old escapeBar. We don't need this now that we use@ for math delim.
  • Moved common code to Text.Pandoc.Writers.Roff and toText.Pandoc.RoffChar.
  • Move splitSentences to Text.Pandoc.Shared (to avoid duplicationwith the man writer).

• Text.Pandoc.Writers.Muse (Alexander Krotov).

+ Add support for grid tables.+ Fix Muse writer style.+ Use `length` instead of `realLength` to calculate definition indentation. Muse parsers don't take character width into account when calculating indentation.+ Do not insert newline before lists.+ Use lightweight markup after `</em>` tag.

• New unexported module Text.Pandoc.Writers.Roff, providing functionsuseful for all roff format writers (man, ms).

• Text.Pandoc.Lua

  • Move globals handling to separate module Text.Pandoc.Lua.Global(Albert Krewinkel).

  • Lua filter internals: push Shared.Element as userdata (AlbertKrewinkel). Hierarchical Elements were pushed to Lua as plaintables. This is simple, but has the disadvantage that marshalingis eager: all child elements will be marshaled as part of theobject. Using a Lua userdata object instead allows lazy accessto fields, causing content marshaling just (but also each time)when a field is accessed. Filters which do not traverse the fullelement contents tree become faster as a result.

Default template changes

• LaTeX template:

  • Add variable hyperrefoptions (#4925, Mathias Walter).
  • Add variable romanfont, romanfontoptions (#4665, OvidiusCicero).

• AsciiDoc template: use single-line style for title.

• revealjs template: Fix typo in the socket.io javascript plugin (#5006,Yoan Blanc).

• Text.Pandoc.Lua.Util: add missing docstring to defineHowTo(Albert Krewinkel).

• data/pandoc.lua: add datatype ListAttributes (Albert Krewinkel)

• data/sample.lua: replace custom pipe function with pandoc.utils.pipe(Albert Krewinkel).

Documentation improvements

• INSTALL.md

  • Add chromeos install instructions (#4958) (Evan Pratten).
  • Add note about TinyTeX.

• MANUAL.txt

  • Change groff -> roff.
  • Implement --ascii for Markdown writer.
  • Clarify LaTeX image dimensions output (Mauro Bieg).

• doc/customizing-pandoc.md: added skeleton (Mauro Bieg, #3288).

• doc/getting-started.md: Added title to test1.md to avoid warning.

• doc/lua-filters.md: merge type references into main document,fix description of Code.text (Albert Krewinkel).

Build infrastructure improvements

• Makefile

  • Makefile: added quick-cabal, full-cabal targets.
  • Make .msi download targets insensitive to order of appveyor builds.

• Update benchmarks for ghc 8.6.1.

• pandoc.cabal:

+ Enable more compiler warnings (Albert Krewinkel).+ Make base lower bound 4.8.+ Bump upper bound for QuickCheck.+ Bump upper bound for binary.+ Updated version bounds for containers and haddock-library (#4974).+ Added docx/docPropos/custom.xml to cabal data-files.+ Require skylighting 0.7.4 (#4920).+ New dependency on unicode-transforms package for normalization.

• Improved .travis.yml testing and test with GHC 8.6.1 (Albert Krewinkel).

• Added tools/changelog-helper.sh.

• Added test/grofftest.sh for testing the man reader on real man pages.

pandoc 2.3.1 (2018-09-28)

• RST reader:

  • Parse RST inlines containing newlines (#4912, Francesco Occhipinti).This eliminates a regression introduced after pandoc 2.1.1, whichcaused inline constructions containing newlines not to be recognized.
  • Fix bug with internal link targets (#4919). They were gobbling upindented content underneath.

• Markdown reader: distinguish autolinks in the AST. With this change,autolinks are parsed as Links with the uri class. (The same is truefor bare links, if the autolink_bare_uris extension is enabled.)Email autolinks are parsed as Links with the email class. Thisallows the distinction to be represented in the AST.

• Org reader:

  • Force inline code blocks to honor export options (Brian Leung).
  • Parse empty argument array in inline src blocks (Brian Leung).

• Muse reader (Alexander Krotov):

  • Added additional tests.
  • Do not allow code markup to be followed by digit.
  • Remove heading level limit.
  • Simplify <literal> tag parsers
  • Parse Text instead of String. Benchmark shows 7% improvement.
  • Get rid of HTML parser dependency.
  • Various code improvements.

• ConTeXt writer: change \ to / in Windows image paths (#4918).We do this in the LaTeX writer, and it avoids problems.Note that / works as a LaTeX path separator on Windows.

• LaTeX writer:

  • Add support for multiprenote and multipostnote argumentswith --biblatex (Brian Leung, #4930). The multiprenotes occur beforethe first prefix of a multicite, and the multipostnotes follow thelast suffix.
  • Fix a use of last that might take empty list. If you ran with--biblatex and have an empty document (metadata but no blocks),pandoc would previously raise an error because of the use oflast on an empty list.

• RTF writer: Fix build failure with ghc-8.6.1 caused by missingMonadFail instance (Jonas Scholl).

• ODT Writer: Improve table header row style handling (Nils Carlson).This changes the way styles for cells in the header rowand normal rows are handled in ODT tables.Previously a new (but identical) style was generated forevery table, specifying the style of the cells within the table.After this change there are two style definitions for table cells,one for the cells in the header row, one for all other cells.This doesn't change the actual styles, but makes post-processingchanges to the table styles much simpler as it is no longernecessary to introduce new styles for header rows and there arenow only two styles where there was previously one per table.

• HTML writer:

  • Don't add uri class to presumed autolinks. Formerly the uriclass was added to autolinks by the HTML writer, but it had toguess what was an autolink and could not distinguish[http://example.com](http://example.com) from<http://example.com>. It also incorrectly recognized[pandoc](pandoc) as an autolink. Now the HTML writersimply passes through the uri attribute if it is present,but does not add anything.
  • Avoid adding extra section nestings for revealjs.Previously revealjs title slides at level (slidelevel - 1)were nested under an extra section element, even whenthe section contained no additional (vertical) content.That caused problems for some transition effects.
  • Omit unknown attributes in EPUB2 output. For example,epub:type attributes should not be passed through,or the epub produced will not validate.

• JATS writer: remove 'role' attribute on 'bold' and 'sc' elements (#4937).The JATS spec does not allow these.

• Textile writer: don't represent uri class explicitlyfor autolinks (#4913).

• Lua filters (Albert Krewinkel):

  • Cleanup filter execution code.
  • Better error on test failure.

• HTML, Muse reader tests: reduce time taken by round-trip test.

• Added cabal.project.

• MANUAL: epub:type is only useful for epub3 (Maura Bieg).

• Use hslua v1.0.0 (Albert Krewinkel).

• Fix translations/ru to use modern Russian orthography(Ivan Trubach).

• Build Windows binary using ghc 8.6.1 and cabal new-build. Thisfixes issues with segfaults in the 32-bit Windows binaries (#4283).

pandoc 2.3 (2018-09-16)

• Add --metadata-file option (Mauro Bieg, #1960), which allowsusers to specify metadata in a YAML file, regardless of theinput format (#1960).

• Text.Pandoc.Writers.Shared: export isDisplayMath (API change).

• Text.Pandoc.Readers.Markdown: export yamlToMeta (API change,Mauro Bieg).

• Text.Pandoc.Readers.LaTeX.Types:

  • New type ArgSpec (API change).
  • Second parameter of Macro constructor is now [ArgSpec] instead ofInt (API change).

• Markdown reader:

  • Use tex instead of latex for raw tex-ish content. We can'talways tell if it's LaTeX, ConTeXt, or plain TeX. Better just touse tex always. Note that if context or latex specificallyis desired, you can still force that in a markdown document byusing the raw attribute. Note that this change may affect somefilters, if they assume that raw tex parsed by the Markdown readerwill be RawBlock (Format latex). In most cases it should betrivial to modify the filters to accept tex as well.
  • Refactor and reorganize YAML code (Mauro Bieg).
  • Make example_lists work for interrupted listswithout startnum (#4908).

• HTML reader:

  • Parse <script type="math/tex tags as math (#4877).These are used by MathJax in some configurations.
  • Extract spaces inside links instead of trimming them(Alexander Krotov, #4845).
  • Added round-trip tests (Alexander Krotov).
  • Make parsing sensitive to the raw_tex extension (#1126). This nowallows raw LaTeX environments, \ref, and \eqref to be parsed(which is helpful for translation HTML documents using MathJaX).

• Org reader (Albert Krewinkel):

  • Respect export option p for planning info. Inclusion of planning info(*DEADLINE*, *SCHEDULED*, and *CLOSED*) can be controlled via thep export option: setting the option to t will add all planninginformation in a Plain block below the respective headline.
  • Org reader internals: don't rely on RecordWildCards and ViewPatternsghc extensions.
  • Strip planning info from output. Planning info is parsed, but notincluded in the output (as is the default with Emacs Org-mode, #4867).

• LaTeX reader:

  • Handle parameter patterns for \def (#4768, #4771).For example: \def\foo#1[#2]{#1 and #2}.
  • Allow % characters in URLs. This affects \href and \url (#4832).
  • Fixed parsing of \texorpdfstring. We were returning the wrongargument as the content.
  • Support blockcquote, foreignblockquote, foreigncblockquote,hyphenblockquote, hyphencblockquote, enquote*, foreignquote,hyphenquote from csquotes (#4848). Note that foreignquotewill be parsed as a regular Quoted inline (not using the quotesappropriate to the foreign language).
  • Support more text-mode accents (#4652). Add support for \|, \b, \G,\h, \d, \f, \r, \t, \U, \i, \j, \newtie,\textcircled. Also fall back to combining characters when composedcharacters are not available.
  • Resolve \ref for figure numbers.
  • Support mintinline (#4365, Marc Schreiber).
  • Fix siunitx unit commands so they are only recognized insiunitx contexts (#4842). For example, \l outside of ansiunitx context should be l-slash, not l (for liter).
  • Fix double unnumbered class (#4838). The unnumbered classwas being included twice for starred sections.

• RST reader: Don't skip link definitions after comments (#4860).

• Muse reader (Alexander Krotov):

  • Close the </quote> in indented tag test.There is already a separate test for unclosed </quote>.
  • Autonumber sections in the correct order. Parsing now stopsat each section header to ensure the header is registered beforeparsing of the next section starts.
  • Move duplicate code into headingStart function.
  • Allow newline after opening * or **.
  • Don't allow digits after closing marker in lightweight markupThis change makes reader more compatible with Emacs Muse.
  • Parse <verse> tag in one pass instead of usingparseFromString. This change makes it possible to haveverbatim </verse> tag inside verse.

• ODT reader: deal gracefully with missing <office:font-face-decls/>(#4336). This allows pandoc to parse ODT document produced by KDE'sCalligra.

• Muse writer (Alexander Krotov):

  • Output headers without asterisks if not on the top level.
  • Never wrap definition list terms.
  • Set envInsideBlock = True when rendering notes.
  • Use "" instead of [] for empty String.
  • Check for whitespace in the beginning and end of Str's.
  • Escape -, ; and > in the beginning of strings.
  • Escape list markers in the beginning of notes.
  • Normalize inline list before testing if tags should be used.
  • Use tags instead of lightweight markup for empty strings.
  • Use lightweight markup when possible.
  • Escape empty strings. This guarantees that conditionalEscapeStringnever returns empty string.
  • Wrap conditionalEscapeString result into Muse type.This removes the need to pass envInsideLinkDescription to it.
  • Separate shouldEscapeString function.
  • Simplify inline list rendering.
  • Replace newlines in strings with spaces.

• Docx writer:

  • Add MetaString case for abstract, subtitle (#4900, Mauro Bieg).
  • Properly handle display math in spans (#4826). This isn't acomplete solution, since other nestings of display math may stillcause problems, but it should work for what is by far the mostcommon case.

• HTML writer:

  • Always output <dt> element, even if it is empty (#4883,Alexander Krotov).
  • Don't prefix epub: attributes with data-.

• Org writer: Don't escape literal _, ^ (#4882). Org doesn'trecognize these escapes.

• ODT writer: Fix percentage image scaling (#4881, Nils Carlson).Image scaling was broken when a width was set to a percentage.

• EPUB writer: set epub:type on body element in each chapter,depending on the epub:type of the first section (#4823). Thisonly affects epub3. Seehttp://www.idpf.org/epub/profiles/edu/structure/#h.l0bzsloklt10

• FB2 writer: put coverpage element between title and date rather than indocument-info element (#4854).

• Markdown writer: Escape ~ if strikeout extension enabled (#4840).

• Haddock writer: Use proper format for latex math in haddock (#4571, JoeHermaszewski). Inline math in \(..\), display math in \[..\],tex is now used. Previously we'd "fake it with unicode" and fallback to tex when that didn't work. But newer haddock versionssupport latex math.

• TEI writer:

  • Ensure that title element is always present, even if empty (#4839).
  • Put author tags in the template, rather than adding them inthe writer (#4839).

• LaTeX writer/template: be sensitive to filecolor variable (#4822).linkcolor only affects internal links, and urlcolor onlyaffects linked URLs. For external links, the option to use isfilecolor.

• ConTeXt writer: output raw tex blocks as well as context (#969).

• RST writer:

  • Use .. raw:: latex for tex content.
  • Use .. container for generic Divs, instead of raw HTML.
  • Render Divs with admonition classes as admonitions (#4833).Also omit Div with class admonition-title. These are generatedby the RST reader and should be omitted on round-trip.

• Text.Pandoc.PDF: fix message printed when rsvg-convert is not available(#4855, Antonio Terceiro).

• HTML5 template: add the title-block-header identifier to theheader element, to make it easier to style precisely (#4767,J. B. Rainsberger).

• OpenDocument template: Remove unnecessary indenting of TOC title (#4798,José de Mattos Neto).

• latex template: Add support for \(toc-title\) to LaTeX (and PDF)(#4853, Wandmalfarbe).

• TEI template: improve publicationStmt. Add support forpublisher, address, pubPlace, and date variables.

• beamer template: Support "toc-title" (#4835, Cyril Roelandt).

• Text.Pandoc.Extensions: Fix haddock on Ext_footnotes (Chris Martin).

• Lua: cleanup Lua utils, remove unused functions (Albert Krewinkel).

• MANUAL.txt:

  • Clarify that --biblatex/--natbib don't work directly for PDF(#4904).
  • Document epub:type attribute (Mauro Bieg, #4901)
  • Clarify when --resource-path has an effect.
  • More detail on customization in syntax highlighting section.
  • Document encoding issue with --listings (#4871, Damien Clochard).
  • Remove docs on removed --katex-stylesheet (Mauro Bieg, #4862).
  • Use https for context wiki links (#4910).

• CONTRIBUTING.md:

  • Link to lua-filters repository (#4874).
  • Fix mistake in REPL instructions for stack. (#4849, Brian Leung).

• lua-filters.md: add links to filters, and to lua-filters repository(#4874).

• INSTALL.md:

  • Indicate that cabal >= 2.0 is needed.
  • Added chocolatey installation method (#4844, Miodrag Milić).

• Travis: exclude round-trip tests, except for nightly test which can fail.

• Use latest texmath, pandoc-citeproc.

• Use a patched version of foundation untilhttps://github.com/haskell-foundation/foundation/pull/503is fixed.

• Clean up appveyor build and Windows package creation.We now use 64-bit stack and ghc 8.4.3, lts-12 for the 64-bit build. TheWiX-based msi is now 64-bit for 64-bit builds (fixing #4795).

• Remove obsolete RELEASE-CHECKLIST.md.

• Added additional compiler warnings in Makefile and CI builds.

pandoc 2.2.3.2 (2018-08-07)

• Markdown reader: Properly handle boolean values in YAML metadata (#4819).This fixes a regression in 2.2.3, which cause boolean values tobe parsed as MetaInlines instead of MetaBool.

  We here record another undocumented (but desirable) change in 2.2.3:numerical metadata fields are now parsed as MetaInlines rather thanMetaString.

pandoc 2.2.3.1 (2018-08-06)

• Markdown reader: Fix parsing of embedded mappings in YAML metadata(#4817). This fixes a regression in 2.2.3 which caused embeddedmappings (e.g. mappings in sequences) not to work in YAML metadata.

pandoc 2.2.3 (2018-08-05)

• RST reader: improve parsing of inline interpreted text roles (#4811).

  • Use a Span with class "title-reference" for the defaulttitle-reference role.
  • Use B.text to split up contents into Spaces, SoftBreaks,and Strs for title-reference.
  • Use Code with class "interpreted-text" instead of Span and Str forunknown roles. (The RST writer has also been modified to round-tripthis properly.)
  • Disallow blank lines in interpreted text.
  • Backslash-escape now works in interpreted text.
  • Backticks followed by alphanumerics no longer end interpreted text.
  • Remove support for nested inlines (Francesco Occhipinti).RST does not allow nested emphasis, links, or other inlineconstructs. This fixes several bugs (#4581, #4561, #4792).

• Org reader: fix parsers relying on parseFromString (#4784, AlbertKrewinkel). Emphasis was not parsed when it followed directly aftersome block types (e.g., lists).

• Markdown reader: Allow unquoted numbers and booleans as YAML mappingkeys. Previously in 2.2.2 you could not do

  ---0: bar...

  but only

  ---'0': bar...

  With this change, both forms work.

• DocBook reader: metadata handling improvements.Now we properly parse title and subtitle elements that are directchildren of book and article (as well as children of bookinfo,articleinfo, or info). We also now use the subtitle metadatafield for subtitles, rather than tacking the subtitle on to thetitle.

• RST writer:

  • Allow images to be directly nested within links (#4810, FrancescoOcchipinti).
  • Use titleblock instead of title variable for title block (#4803,Francesco Occhipinti). titleblock contains a properly formattedtitle and subtitle (using top-level headers). title andsubtitle variables are still available and just contain thetitle and subtitle text. Note that this change will require anupdate to custom rst templates.
  • Render Code with class "interpreted-text" as interpreted text role.

• MediaWiki writer: Avoid extra blank line in tables with empty cells(#4794). Note that the old output is semantically identical, but thenew output looks better.

• Lua Utils module: add function blocks_to_inlines (#4799, AlbertKrewinkel). Exposes a function converting which flattenes a list ofblocks into a list of inlines. An example use case would be theconversion of Note elements into other inlines.

• RST template: use titleblock instead of title. Users ofcustom RST templates will want to update this.

• LaTeX template: Moved some beamer code in default.latex template.This change allows beamer themes to change the template and font (asMetropolis does) (#4450).

• Better error message on -t pdf -o out.pdf (#1155, Mauro Bieg).

• Added test case for #4669 to repository.

• INSTALL.md: Fix broken link for cabal-install (#4806, ChanHoHo).

• MANUAL.txt:

  • Add beamer info for slide backgrounds (#4802, John Muccigrosso).
  • Clarify when csquotes is used in LaTeX writer (#4514).
  • Add commonmark to list of output formats where raw_tex has aneffect (see #4527).

pandoc 2.2.2.1 (2018-07-19)

• Fix regression finding templates in user data directory (#4777).Under version 2.2.1 and prior pandoc found latex templates in thetemplates directory under the data directory, but this broke in 2.2.2.

• Fix for bug in parsing \input in rawLaTeXBlock andrawLaTeXInline (#4781). (This primarily affects the markdownreader, and other readers that accept raw tex.)Starting in 2.2.2, everything after an \input (or \include)in a markdown file would be parsed as raw LaTeX.

• MANUAL:

  • Clarify gfm vs markdown_github (#4783, Mauro Bieg).
  • Use keywords instead of tags in YAML metadata example (#4779).Unlike tags, keywords is used in some of the writersand default templates.

• Add missing rollingLinks option to revealjs template (#4778,Igor Khorlo).

pandoc 2.2.2 (2018-07-16)

• Use HsYAML instead of yaml for translations and YAML metadata (#4747).yaml wraps a C library; HsYAML is pure Haskell. Advances #4535.

  Note: HsYAML implements YAML 1.2, in which the valid truevalues are true, True, TRUE. This means a change inthe semantics of YAML metadata that could affect users:y, yes, and on no longer count as true values.

• Fix regression: make --pdf-engine work with full paths (#4681, MauroBieg).

• CommonMark reader: Handle ascii_identifiers extension (#4742,Anders Waldenborg). Non-ascii characters were not stripped fromidentifiers even if the ascii_identifiers extension wasenabled (which is is by default for gfm).

• TikiWiki reader: Improve list parsing (#4722, Mauro Bieg).Remove trailing Space from list items. Parse lists that have no spaceafter marker.

• LaTeX reader:

  • Treat lilypond as a verbatim environment (#4725).
  • Parse figure label into Image id (#4700, Mauro Bieg).
  • Beamer: Allow "noframenumbering" option (#4696, Raymond Ehlers).
  • Allow spaces around \graphicspath arguments (#4698).
  • Handle includes without surrounding blanklines (#4553).In addition, \input can now be used in an inline context,e.g. to provide part of a paragraph, as it can in LaTeX.
  • In rawLaTeXBlock, handle macros that resolve to a\begin or \end (#4667).
  • In rawLaTeXBlock, don't expand macros in macro definitions (#4653).Note that this only affected LaTeX in markdown.
  • Tighten up reading of beamer overlay specifications (#4669).Ideally we'd turn these on only when reading beamer, but currentlybeamer is not distinguished from latex as an input format.This commit also activates parsing of overlay specificationsafter commands in general (e.g. \item), since they can occurin many contexts in beamer.
  • Parse more siunitx unit commands (#4296, #4773).
  • Be more forgiving in key/value option parsing (#4761).

• Markdown reader:

  • Allow empty code spans, e.g. ` `.
  • Emojis are now wrapped in Spans with class emoji andattribute data-emoji (Anders Waldenborg, #4743).This allows the writer to handle them in a special way(e.g. using a special font, or just rendering theemoji name).

• Muse reader (Alexander Krotov, except where indicated):

  • Get rid of non-exhaustive pattern match warning (Mauro Bieg).
  • Add support for floating images.
  • Add support for images with specified width.
  • Parse image URLs without "guard" and "takeExtension".
  • Split link and image parsing into separate functions.
  • Parse links starting with "URL:" explicitly instead of trying to strip"URL:" prefix after parsing.

• Texinfo writer: Use @sup and @sub instead of custom macros (#4728,Alexander Krotov).

• Markdown writer: Preserve implicit_figures with attributes, even ifimplicit_attributes is not set, by rendering in raw HTML (#4677).

• Markdown and commonmark/github writers now respect the emojiextension. So, -f markdown+emoji -t markdown+emoji now leaves:smile: as :smile: rather than converting it to a smilecharacter.

• Docx writer: Be sensitive to toc in YAML metadata (#4645).

• ODT/OpenDocument writer: Make internal links work (#4358).This adds proper bookmarks to the headers with non-null IDs.

• EPUB writer: Properly escape pagetitle. Previously we weren'tescaping & and other XML characters in the pagetitle, so a titlecontaining a & would be invalid.

• AsciiDoc Writer: Eescape square brackets at start of line (#4545,Mauro Bieg).

• RST writer:

  • Don't treat 'example' as a syntax name (#4748).This fixes conversions from org with example blocks.
  • Support --number-sections via the section-numberingdirective in standalone output.

• reveal.js writer and template: reuse mathjax URLprovided by the argument to --mathjax or the normal pandoc default,rather than a hard-coded one in the template (#4701).

• LaTeX writer:

  • Properly handle footnotes in table captions (#4683).Refactored code from figure captions to use in both places.
  • In beamer output, fix single digit column percentage (#4690, MauroBieg).

• FB2 writer (Alexander Krotov):

  • Convert Plain to Para in annotation (#2424).
  • Fix order of items in title-info (#2424).

• Custom writer: fix error message on script failure (Albert Krewinkel).Error messages produced by Lua were not displayed by Pandoc.

• Text.Pandoc.Emoji now exports emojiToInline, which returns a Spaninline containing the emoji character and some attributes with metadata(class emoji, attribute data-emoji with emoji name). (API change,Anders Waldenborg, #4743).

• Text.Pandoc.PDF:

  • Revert fix for #4484 (only compress images on last run, #4755).This will mean some increase in the time it takes toproduce an image-heavy PDF with xelatex, but it willmake tables of contents correct, which is more important.
  • Fix logic error in runTeXProgram. We were running the tex programone more time than requested. This should speed up PDF production.

• Allow --template to take a URL as argument.

• Text.Pandoc.Highlighting: Add missing re-export of breezeDarkhighlighting style (#4687, Adrian Sieber, API change).

• Clarify macOS install in INSTALL.md (#4661). Make the binary packageinstaller the recommended method, and note that on some older versions ofmacOS, homebrew installs from source and takes a lot of disk space(#4664, Ian).

• MANUAL:

  • Clarify EPUB linked media (#4756, Mauro Bieg)
  • Update manual for "true" YAML values. Now that we're using HsYAML andYAML 1.2, the valid true values are true, True, TRUE. NOTE!y, yes, on no longer count as true values.
  • Document -F as alias for --filter (thanks to Gandalf Saxe).
  • Update manual on how math is rendered in LaTeX.
  • Add proxy description (#4131, Mauro Bieg).
  • Clarify that --toc requires --standalone (#4703).
  • Update citation styles link (#4699, wiefling).

• In API docs, clarify how Ext_east_asian_line_breaks extension works(kaizshang91). Note that it will not take effect when readers/writersare called as libraries (#4674).

• Improved translations/fr (#4766, lux-lth).

• Removed inadvertently added .orig files from repository (#4648).

• Remove network-uri flag and use 'Network.Socket'.This removes a compiler warning. There is no need for the oldnetwork-uri flag, since network 2.6 was released in 2014.

• Add stack.lts10.yaml, stack.lts11.yaml. use lts-12 in stack.yaml.

• Bump upper bounds for dependent packages.

• Exclude foundation 0.0.21 for ghc 7.10. Otherwise cabal getsconfused because of the way ghc 7.10 is excluded in foundation'scabal file. This can be removed when haskell-foundation/foundation#500is fixed.

• Require cabal-version >= 2.0. This is needed for haddock-library.

pandoc 2.2.1 (2018-05-10)

• Restored and undeprecated gladtex for HTML math (#4607).

  • Added GladTeX constructor to Text.Pandoc.Options.HTMLMathMethod[API change, reverts removal in v2.2]
  • Restored and undeprecated --gladtex option, removed in v2.2.

• LaTeX reader: Handle $ in /text{..} inside math (#4576).

• Org reader: Fix image filename recognition (Albert Krewinkel).Use a function from the filepath library to check whether a string is avalid file name. The custom validity checker that was used before gavewrong results (e.g. for absolute file paths on Windows,kawabata/ox-pandoc#52).

• FB2 reader: Replace some errors with warnings (Alexander Krotov).

• HTML writer:

  • Strip links from headers when creating TOC (#4340).Otherwise the TOC entries will not link to the sections.
  • Fix regression with tex math environments in HTML + MathJax (#4639).

• Muse writer (Alexander Krotov): Add support for left-align andright-align classes (#4542).

• Docx writer: Support underline (#4633).

• Text.Pandoc.Parsing: Lookahead for non-whitespace aftersingleQuoteStart and doubleQuoteStart (#4637).

• test-pandoc-utils.lua: more robust testing on both windowsand *nix. Previously the pipe tests were only run if\bin/false and /bin/sed were present, which they aren'tin default MacOS and Windows systems. Fixed by using trand false, which should always be in the path on a *nixsystem, and find and echo for Windows.

• Text.Pandoc.Shared: add uriPathToPath.This adjusts the path from a file: URI in a way that is sensitiveto Windows/Linux differences. Thus, on Windows,/c:/foo gets interpreted as c:/foo, but on Linux,/c:/foo gets interpreted as /c:/foo. See #4613.

• Use uriPathToPath with file: URIs (#4613).

• Revert piping HTML to pdf-engine (Mauro Bieg, #4413). Use a tempfile as before.

• Text.Pandoc.Class: Catch IO errors when writing media filesand issue a warning, rather than an error (Francesco Occhipinti, #4559).

• Don't lowercase custom writer filename (Alexander Krotov, #4610).

• MANUAL (Mauro Bieg):

  • Clarify truthiness in template variables (#2281).
  • Clarify pipe table width calculation (#4520).

• ConTeXt template: New Greek fallback typeface (Pablo Rodríguez, #4405).CMU Serif gives better typographic results than the previousGreek fallback DejaVu Serif.

• Make HTML template polyglot (#4606, OvidiusCicero), by making<link rel="stylesheet" href="$css$"> self-closing.

• Use texmath 0.11, allowing better translation of non-ASCIIcharacters in math (#4642).

pandoc 2.2 (2018-04-27)

• New input format: fb2 (FictionBook2) (Alexander Krotov).

• Make --ascii work for all XML formats (ICML, OPML, JATS,...),and for ms and man.

• Remove deprecated --latexmathml, --gladtex, --mimetex, --jsmath, -m,--asciimathml options.

• New module Text.Pandoc.Readers.FB2, exporting readFB2 (AlexanderKrotov, API change).

• Markdown reader:

  • Allow empty key-value attributes, like title="" (#2944).
  • Handle table w/o following blank line in fenced div (#4560).
  • Remove "fallback" for doubleQuote parser. Previously theparser tried to be efficient -- if no end double quote was found,it would just return the contents. But this could backfire in acase **this should "be bold**, since the fallback would returnthe content "be bold** and the closing boldface delimiterwould never be encountered.
  • Improve computation of the relative width of the last column in amultiline table, so we can round-trip tables without constantlyshrinking the last column.

• EPUB reader:

  • Fix images with space in file path (#4344).

• LaTeX reader:

  • Properly resolve section numbers with \ref and chapters (#4529).
  • Parse sloppypar environment (#4517, Marc Schreiber).
  • Improve handling of raw LaTeX (for markdown etc.) (#4589, #4594).Previously there were some bugs in how macros were handled.
  • Support \MakeUppercase, \MakeLowercase, \uppercase,\lowercase, and also \MakeTextUppercase and\MakeTextLowercase from textcase (#4959).

• Textile reader:

  • Fixed tables with no body rows (#4513).Previously these raised an exception.

• Mediawiki reader:

  • Improve table parsing (#4508). This fixes detection of tableattributes and also handles ! characters in cells.

• DocBook reader:

  • Properly handle title in section element (#4526).Previously we just got section_title for section (though sect1,sect2, etc. were handled properly).
  • Read tex math as output by asciidoctor (#4569, Joe Hermaszewski).

• Docx reader:

  • Combine adjacent CodeBlocks with the same attributes intoa single CodeBlock. This prevents a multiline codeblock inWord from being read as different paragraphs.

• RST reader:

  • Allow < 3 spaces indent under directives (#4579).
  • Fix anonymous redirects with backticks (#4598).

• Muse reader (Alexander Krotov):

  • Add support for Text::Amuse multiline headings.
  • Add <math> tag support.
  • Add support for <biblio> and <play> tags.
  • Allow links to have empty descriptions.
  • Require block <literal> tags to be on separate lines.
  • Allow - in anchors.
  • Allow verse to be indented.
  • Allow nested footnotes.
  • Internal improvements.

• Muse writer (Alexander Krotov):

  • Escape > only at the beginning of a line.
  • Escape ] in image title.
  • Escape ] brackets in URLs as %5D.
  • Only escape brackets when necessary.
  • Escape ordered list markers.
  • Do not escape list markers unless preceded by space.
  • Escape strings starting with space.
  • Escape semicolons and markers after line break.
  • Escape ; to avoid accidental comments.
  • Don't break headers, line blocks and tables with line breaks.
  • Correctly output empty headings.
  • Escape horizontal rule only if at the beginning of the line.
  • Escape definition list terms starting with list markers.
  • Place header IDs before header.
  • Improve span writing.
  • Do not join Spans in normalization.
  • Don't align ordered list items.
  • Remove key-value pairs from attributes before normalization.
  • Enable --wrap=preserve for all tests by default.
  • Reduced <verbatim> tags in output.
  • Internal changes.

• RST writer:

  • Use more consistent indentation (#4563). Previously weused an odd mix of 3- and 4-space indentation. Now we use 3-spaceindentation, except for ordered lists, where indentation mustdepend on the width of the list marker.
  • Flatten nested inlines (#4368, Francesco Occhipinti).Nested inlines are not valid RST syntax, so we flatten them followingsome readability criteria discussed in #4368.

• EPUB writer:

  • Ensure that pagetitle is always set, even when structured titlesare used. This prevents spurious warnings about empty titleelements (#4486).

• FB2 writer (Alexander Krotov):

  • Output links inline instead of producing notes. Previously all linkswere turned into footnotes with unclickable URLs inside.
  • Allow emphasis and notes in titles.
  • Don't intersperse paragraph with empty lines.
  • Convert metadata value abstract to book annotation.
  • Use <empty-line /> for HorizontalRule rather than LineBreak.FB2 does not have a way to represent line breaks inside paragraphs;previously we used <empty-line /> elements, but these are not allowedinside paragraphs.

• Powerpoint writer (Jesse Rosenthal):

  • Handle Quoted Inlines (#4532).
  • Simplify code with ParseXml.
  • Allow fallback options when looking for placeholder type.
  • Check reference-doc for all layouts.
  • Simplify speaker notes logic.
  • Change notes state to a simpler per-slide value.
  • Remove Maybe from SpeakerNotes in Slide. memptymeans no speaker notes.
  • Add tests for improved speaker notes.
  • Handle speaker notes earlier in the conversion process.
  • Keep notes with related blocks (#4477). Some blocks automaticallysplit slides (imgs, tables, column divs). We assume that anyspeaker notes immediately following these are connected to theseelements, and keep them with the related blocks, splitting after them.
  • Remove docProps/thumbnail.jpeg in data dir (Jesse Rosenthal, #4588).It contained a nonfree ICC color calibration profile and is not neededfor production of a powerpoint document.

• Markdown writer:

  • Include a blank line at the end of the row in a single-row multilinetable, to prevent it from being interpreted as a simple table (#4578).

• CommonMark writer:

  • Correctly ignore LaTeX raw blocks when raw_tex is notenabled (#4527, quasicomputational).

• EPUB writer:

  • Add epub:type="footnotes" to notes section in EPUB3 (#4489).

• LaTeX writer:

  • In beamer, don't use format specifier for default ordered lists(#4556). This gives better results for styles that put ordered listmarkers in boxes or circles.
  • Update \lstinline delimiters (#4369, Tim Parenti).

• Ms writer:

  • Use \f[R] rather than \f[] to reset font (#4552).
  • Use \f[BI] and \f[CB] in headers, instead of \f[I] and \f[C],since the header font is automatically bold (#4552).
  • Use \f[CB] rather than \f[BC] for monospace bold (#4552).
  • Create pdf anchor for a Div with an identifier (#4515).
  • Escape / character in anchor ids (#4515).
  • Improve escaping for anchor ids: we now use uNNN instead of uNNNto avoid ambiguity.

• Man writer:

  • Don't escape U+2019 as ' (#4550).

• Text.Pandoc.Options:

  • Removed JsMath, LaTeXMathML, and GladTeX constructors fromText.Pandoc.Options.HTMLMathMethod [API change].

• Text.Pandoc.Class:

  • writeMedia: unescape URI-escaping in file path. This avoidswriting things like file%20one.png to the file system.

• Text.Pandoc.Parsing:

  • Fix romanNumeral parser (#4480). We previously accepted 'DDC'as 1100.
  • uri: don't treat * characters at end as part of URI (#4561).

• Text.Pandoc.MIME:

  • Use the alias application/eps for EPS (#2067).This will ensure that we retain the eps extension after reading theimage into a mediabag and writing it again.

• Text.Pandoc.PDF:

  • Use withTempDir in html2pdf.
  • With xelatex, don't compress images til the last run (#4484).This saves time for image-heavy documents.
  • Don't try to convert EPS files (#2067). pdflatex converts themitself, and JuicyPixels can't do it.
  • For pdflatex, use a temp directory in the working directory.Otherwise we can have problems with the EPS conversion pdflatextries to do, which can't operate on a file above the workingdirectory without --shell-escape.

• Changes to tests to accommodate changes in pandoc-types.In https://github.com/jgm/pandoc-types/pull/36 we changedthe table builder to pad cells. This commit changes tests(and two readers) to accord with this behavior.

• Set default extensions for beamer same as latex.

• LaTeX template:

  • Add beameroption variable (#4359, Étienne Bersac).
  • Use pgfpages package; this is needed for notes on secondscreen in beamer (Étienne Bersac).
  • Add background-image variable (#4601, John Muccigrosso).

• reveal.js template: Add background-image variable (#4600,John Muccigrosso).

• ms template: Fix date. Previously .ND was used, but this onlyworks if you have a title page, which we don't. Thanks to @teoric.

• Removed pragmas for unused extensions (#4506, Anabra).

• Fix bash completion for --print-default-data-file (#4549).Previously this looked in the filesystem, even if pandocwas compiled with embed_data_files (and sometimes it lookedin a nonexistent build directory). Now the bash completionscript just includes a hard-coded list of data file names.

• MANUAL:

  • Clarify template vs metadata variables (#4501, Mauro Bieg).
  • Fix raw content example (#4479, Mauro Bieg).
  • Specify that you use html for raw output in epub.
  • Add examples for raw docx blocks (#4472, Tristan Stenner).The documentation states that the target format name should matchthe output format, which isn't the case for docx/openxml andsome others.
  • Don't say that empty_paragraphs affects markdown output (#4540).
  • Consolidate input/output format documentation (#4577, Mauro Bieg).

• New README template. Take in/out formats from manual.

• Fix example in lua-filters docs (#4459, HeirOfNorton).

• Use the -threaded GHC flag when building benchmarks (#4587,Francesco Occhipinti).

• Bump temporary upper bound to 1.4.

• Use pandoc-citeproc 0.14.3.1.

• Use texmath-0.10.1.2 (fixes escapes in math in ms, #4597).

• Removed old lib directory. This was used for something long ago,but plays no role now.

• Removed unneeded data file LaTeXMathML.js.

• Create 64- and 32-bit versions of Windows binary packages.

pandoc 2.1.3 (2018-03-18)

• Docx reader (Jesse Rosenthal):

  • Add tests for nested smart tags.
  • Parse nested smart tags.
  • Make unwrapSDT into a general unwrap function that can unwrap bothnested SDT tags and smartTags. This makes the SmartTags constructor inthe Docx type unnecessary, so we remove it (#4446).
  • Remove unused docxWarnings (Alexander Krotov).

• RST reader: Allow unicode bullet characters (#4454).

• Haddock reader: Better table handling, using haddock-library'snew table support, if compiled against a version thatincludes it. Note that tables with col/rowspans will nottranslate well into Pandoc.

• Muse reader (Alexander Krotov):

  • Various internal improvements.
  • Require closing tag to have the same indentation as opening.
  • Do not reparse blocks inside unclosed block tag (#4425).
  • Parse <class> tag (supported by Emacs Muse).
  • Do not produce empty Str element for unindented verse lines.

• LaTeX reader:

  • Add support to parse unit string of \SI command (closes #4296,Marc Schreiber).

• Haddock writer: In the writer, we now render tables always asgrid tables, since Haddock supports these.

• DokuWiki writer: rewrite backSlashLineBreaks (#4445, Mauro Bieg).

• Docx writer: Fixed formatting of DefaultStyle ordered lists indocx writer. We want decimal for the top level, not lower roman.

• RST writer:

  • Strip whitespace at beginning and ending of inline containers(#4327, Francesco Occhipinti).
  • Filter out empty inline containers (#4434). There is nothing inRST that corresponds to e.g. Emph [], so we just ignore elementslike this (Francesco Occhipinti).

• Muse writer (Alexander Krotov):

  • Support spans with anchors.
  • Replace smallcaps with emphasis before normalization.
  • Output smallcaps as emphasis.
  • Expand Cite before list normalization.
  • Write empty inline lists as <verbatim></verbatim>.
  • Remove empty Str from the beginning of inline lists during normalization.
  • Escape "-" to avoid creating bullet lists.
  • Fix math expansion for more than one expression per paragraph.
  • Expand math before inline list normalization.

• Dokuwiki writer: fix LineBreaks in Tables (#4313, Mauro Bieg).

• Ms writer:

  • Asciify pdf anchors, since unicode anchors don't work (#4436).Internal links should be converted automatically, so this shouldn'taffect users directly.
  • Don't escape hyphens as \-; that's for a minus sign (#4467).

• Beamer writer: put hyperlink after \begin{frame} and not in the title(#4307). If it's in the title, then we get a titlebar on slides withthe plain attribute, when the id is non-null. This fixes a regressionin 2.0.

• EPUB writer: Remove notes from TOC in nav.xhtml (#4453, Mauro Bieg).

• JATS writer: Remove extraneous, significant whitespace (#4335,Nokome Bentley).

• html2pdf: inject base tag with current working directory (#4413, MauroBieg). This helps ensure that linked resources are included.

• Add Semigroup instances for everything for which we defined aMonoid instance previously (API change):

  • Text.Pandoc.Class.FileTree.
  • Text.Pandoc.Translations.Translations.
  • Text.Pandoc.Extensions.Extensions.
  • Text.Pandoc.Readers.Odt.StyleReader.Styles.
  • Text.Pandoc.Pretty.Doc.
  • Text.Pandoc.MediaBag.MediaBag.

• Add custom Prelude to give clean code for Monoid and Semigroupthat works with ghc 7.10-8.4. The custom Prelude (prelude/Prelude)is used for ghc versions < 8.4. NoImplicitPrelude is usedin all source files, and Prelude is explicitly imported(this is necessary for ghci to work properly with the custom prelude).

• Text.Pandoc.Writers.Shared (Francesco Occhipinti):

  • Export stripLeadingTrailingSpace.
  • Don't wrap lines in grid tables when --wrap=none (#4320).
  • gridTable: Don't wrap lines in tables when --wrap=none. Instead,expand cells, even if it results in cells that don't respect relativewidths or surpass page column width. This change affects RST,Markdown, and Haddock writers.

• Raise error if someone tries to print docx, odt, etc. template (#4441).

• LaTeX template: Provide bidi package's option using\PassOptionsToPackage (#4357, Václav Haisman). This avoid aclash when polyglossia loads it first and then it is loaded againfor XeLaTeX.

• ConTeXt template: Added pdfa variable to generate PDF/A (#4294, HenriMenke). Instructions on how to install the ICC profiles on ConTeXtstandalone can be found in the wiki:http://wiki.contextgarden.net/PDFX#ICC_profiles.If the ICC profiles are not available the log will contain errormessages.

• Use latest pandoc-types, skylighting

• Use latest pandoc-citeproc in binary package.

• Bump upper bound for time, criterion, haddock-library, exceptions,http-types, aeson, haddock-library.

• Bump upper bound tasty-quickcheck 0.10 (#4429, Felix Yan).

• pandoc.cabal: fix up other-extensions and language fields.Language is now consistently Haskell2010, and other-extensionsis consistently NoImplicitPrelude. Everything else to be specifiedin the module header as needed.

• Removed old-locale flag and Text.Pandoc.Compat.Time.This is no longer necessary since we no longer support ghc 7.8.

• Make weigh-pandoc into a benchmark program.Remove weigh-pandoc flag. weigh-pandoc is now built (and run)automatically when you build (and run) benchmarks.

• MANUAL: add instructions for background images reveal.js (#4325, JohnMuccigrosso).

• appveyor: use VS 2013 environment instead of VS 2015 for Windows builds.

pandoc 2.1.2 (2018-03-02)

• Markdown reader:

  • Fix parsing bug with nested fenced divs (#4281). Previously we allowed"nonindent spaces" before the opening and closing :::, but thisinterfered with list parsing, so now we require the fences to be flush withthe margin of the containing block.

• Commonmark reader:

  • raw_html is now on by default. It can be disabled explicitlyusing -f commonmark-raw_html.

• Org reader (Albert Krewinkel):

  • Move citation tests to separate module.

  • Allow changing emphasis syntax (#4378). The characters allowed beforeand after emphasis can be configured via #+pandoc-emphasis-pre and#+pandoc-emphasis-post, respectively. This allows to change whichstrings are recognized as emphasized text on a per-document or evenper-paragraph basis. Example:

    #+pandoc-emphasis-pre: "-\t ('\"{"#+pandoc-emphasis-post: "-\t\n .,:!?;'\")}["

• LaTeX reader:

  • Fixed comments inside citations (#4374).
  • Fix regression in package options including underscore (#4424).
  • Make --trace work.
  • Fixed parsing of tabular* environment (#4279).

• RST reader:

  • Fix regression in parsing of headers with trailing space (#4280).

• Muse reader (Alexander Krotov):

  • Enable <literal> tags even if amuse extension is enabled.Amusewiki disables tags for security reasons.If user wants similar behavior in pandoc, RawBlocks and RawInlinescan be removed or replaced with filters.
  • Remove space prefix from <literal> tag contents.
  • Do not consume whitespace while looking for closing end tag.
  • Convert alphabetical list markers to decimal in round-trip test.Alphabetical lists are an addition of Text::Amuse.They are not present in Emacs Muse and can be ambiguouswhen list starts with "i.", "c." etc.
  • Allow <quote> and other tags to be indented.
  • Allow single colon in definition list term.
  • Fix parsing of verse in lists.
  • Improved parsing efficiency. Avoid parseFromString.Lists are parsed in linear instead of exponential time now.
  • Replace ParserState with MuseState.
  • Prioritize lists with roman numerals over alphabetical lists.This is to make sure "i." starts a roman numbered list,instead of a list with letter "i" (followed by "j", "k", ...").
  • Fix directive parsing.
  • Parse definition lists with multiple descriptions.
  • Parse next list item before parsing more item contents.
  • Fixed a bug: headers did not terminate lists.
  • Move indentation parsing from definitionListItem to definitionList.
  • Paragraph indentation does not indicate nested quote.Muse allows indentation to indicate quotation or alignment,but only on the top level, not within a or list.
  • Require that block tags are on separate lines.Text::Amuse already explicitly requires it anyway.
  • Fix matching of closing inline tags.
  • Various internal changes.
  • Fix parsing of nested definition lists.
  • Require only one space for nested definition list indentation.
  • Do not remove trailing whitespace from <code>.
  • Fix parsing of trailing whitespace. Newline after whitespace nowresults in softbreak instead of space.

• Docx reader (Jesse Rosenthal, except where noted):

  • Handle nested sdt tags (#4415).
  • Don't look up dependant run styles if +styles is enabled.
  • Move pandoc inline styling inside custom-style span.
  • Read custom styles (#1843). This will read all paragraph andcharacter classes as divs and spans, respectively. Dependent styleswill still be resolved, but will be wrapped with appropriate styletags. It is controlled by the +styles extension (-f docx+styles).This can be used in conjunction with the custom-style feature in thedocx writer for a pandoc-docx editing workflow. Users can convert froman input docx, reading the custom-styles, and then use that same inputdocx file as a reference-doc for producing an output docx file. Styleswill be maintained across the conversion, even if pandoc doesn'tunderstand them.
  • Small change to Fields hyperlink parser. Previously, unquoted stringrequired a space at the end of the line (and consumed it). Now weeither take a space (and don't consume it), or end of input.
  • Pick table width from the longest row or header (Francesco Occhipinti,#4360).

• Muse writer (Alexander Krotov):

  • Change verse markup: > instead of <verse> tag.
  • Remove empty strings during inline normalization.
  • Don't indent nested definition lists.
  • Use unicode quotes for quoted text.
  • Write image width specified in percent in Text::Amuse mode.
  • Don't wrap displayMath into <verse>.
  • Escape nonbreaking space (~~).
  • Join code with different attributes during normalization.
  • Indent lists inside Div.
  • Support definitions with multiple descriptions.

• Powerpoint writer (Jesse Rosenthal):

  • Use table styles This will use the default table style in thereference-doc file. As a result they will be easier when usingin a template, and match the color scheme.
  • Remove empty slides. Because of the way that slides were split, thesecould be accidentally produced by comments after images. When animationsare added, there will be a way to add an empty slide with eitherincremental lists or pauses.
  • Implement syntax highlighting. Note that background colors can'tbe implemented in PowerPoint, so highlighting styles that requirethese will be incomplete.
  • New test framework for pptx. We now compare the output of thePowerpoint writer with files that we know to (a) not be corrupt,and (b) to show the desired output behavior (details below).
  • Add notesMaster to presentation.xml if necessary.
  • Ignore links and (end)notes in speaker notes.
  • Output speaker notes.
  • Read speaker note templates conditionally. If there are speakernotes in the presentation, we read in the notesMasters templatesfrom the reference pptx file.
  • Fix deletion track changes (#4303, Jesse Rosenthal).

• Markdown writer: properly escape @ to avoid capture as citation(#4366).

• LaTeX writer:

  • Put hypertarget inside figure environment (#4388).This works around a problem with the endfloat package andmakes pandoc's output compatible with it.
  • Fix image height with percentage (#4389). This previously causedthe image to be resized to a percentage of textwidth, rather thantextheight.

• ConTeXt writer (Henri Menke):

  • New section syntax and support --section-divs (#2609).\section[my-header]{My Header} ->\section[title={My Header},reference={my-header}].The ConTeXt writer now supports the --section-divs option towrite sections in the fenced style, with \startsection and\stopsection.
  • xtables: correct wrong usage of caption (Henri Menke).

• Docx writer:

  • Fix image resizing with multiple images (#3930, Andrew Pritchard).
  • Use new golden framework (Jesse Rosenthal).
  • Make more deterministic to facilitate testing (Jesse Rosenthal).
    • getUniqueId now calls to the state to get an incremented digit,instead of calling to P.uniqueHash.
    • we always start the PRNG in mkNumbering/mkAbstractNum with the sameseed (1848), so our randoms should be the same each time.
  • Fix ids in comment writing (Jesse Rosenthal). Comments from--track-changes=all were producing corrupt docx, because thewriter was trying to get id from the (ID,_,_) field ofthe attributes, and ignoring the "id" entry in the key-value pairs. Wenow check both.

• Ms writer: Added papersize variable.

• TEI writer:

  • Use height instead of depth for images (#4331).
  • Ensure that id prefix is always used.
  • Don't emit role attribute; that was a leftover from theDocbook writer.
  • Use 'xml:id', not 'id' attribute (#4371).

• AsciiDoc writer:

  • Do not output implicit heading IDs (#4363, AlexanderKrotov). Convert to asciidoc-auto_identifiers for old behaviour.

• RST writer:

  • Remove blockToRST' moving its logic into fixBlocks(Francesco Occhipinti).
  • Insert comment between lists and quotes (#4248, Francesco Occchipinti).

• RST template: remove definition of 'math' role as raw.This used to be needed prior to v 0.8 of docutils, butnow math support is built-in.

• Slides: Use divs to set incremental/non-incremental (#4381,Jesse Rosenthal). The old method (list inside blockquote) stillworks, but we are encouraging the use of divs with classincremental or nonincremental.

• Text.Pandoc.ImageSize:

  • Make image size detection for PDFs more robust (#4322).
  • Determine image size for PDFs (#4322).
  • EMF Image size support (#4375, Andrew Pritchard).

• Text.Pandoc.Extensions:

  • Add Ext_styles (Jesse Rosenthal, API change). This will be used inthe docx reader (defaulting to off) to read pargraph and characterstyles not understood by pandoc (as divs and spans, respectively).
  • Made Ext_raw_html default for commonmark format.

• Text.Pandoc.Parsing:

  • Export manyUntil (Alexander Krotov, API change).
  • Export improved sepBy1 (Alexander Krotov).
  • Export list marker parsers: upperRoman, lowerRoman,decimal, lowerAlpha, upperAlpha (Alexander Krotov, API change).

• Tests/Lua: fix tests on windows (Albert Krewinkel).

• Lua: register script name in global variable (#4393). The name of the Luascript which is executed is made available in the global Lua variablePANDOC_SCRIPT_FILE, both for Lua filters and custom writers.

• Tests: Abstract powerpoint tests out to OOXML tests (Jesse Rosenthal).There is very little pptx-specific in these tests, so we abstract outthe basic testing function so it can be used for docx as well. Thisshould allow us to catch some errors in the docx writer that slippedby the roundtrip testing.

• Lua filters: store constructors in registry (Albert Krewinkel). Luafunctions used to construct AST element values are stored in the Luaregistry for quicker access. Getting a value from the registry is muchfaster than getting a global value (partly to idiosyncrasies of hslua);this change results in a considerable performance boost.

• Documentation:

  • doc/org.md Add draft of Org-mode documentation (Albert Krewinkel).
  • doc/lua-filters.md: document global vars set for filters(Albert Krewinkel).
  • INSTALL.md: mention Stack version. (#4343, Adam Brandizzi).
  • MANUAL: add documentation on custom styles (Jesse Rosenthal).
  • MANUAL.txt: Document incremental and nonincremental divs (JesseRosenthal). Blockquoted lists are still described, but fenced divs arepresented in preference.
  • MANUAL.txt: document header and footer variables (newmana).
  • MANUAL.txt: self-contained implies standalone (#4304, Daniel Lublin).
  • CONTRIBUTING.md: label was renamed. (#4310, Alexander Brandizzi).

• Require tagsoup 0.14.3 (#4282), fixing HTML tokenization bug.

• Use latest texmath.

• Use latest pandoc-citeproc.

• Allow exceptions 0.9.

• Require aeson-pretty 0.8.5 (#4394).

• Bump blaze-markup, blaze-html lower bounds to 0.8, 0.9 (#4334).

• Update tagsoup to 0.14.6 (Alexander Krotov, #4282).

• Removed ghc-prof-options. As of cabal 1.24, sensible defaults are used.

• Update default.nix to current nixpkgs-unstable for hslua-0.9.5 (#4348,jarlg).

pandoc 2.1.1 (2018-01-18)

• Markdown reader:

  • Don't coalesce adjacent raw LaTeX blocks if they are separated by ablank line. See lierdakil/pandoc-crossref#160.
  • Improved inlinesInBalancedBrackets (#4272, jgm/pandoc-citeproc#315).The change both improves performance and fixes a regression wherebynormal citations inside inline notes and figure captions were notparsed correctly.

• RST reader:

  • Better handling for headers with an anchor (#4240). Instead of creating aDiv containing the header, we put the id directly on the header.This way header promotion will work properly.
  • Add aligned environment when needed in math (#4254). rst2latex.pyuses an align* environment for math in .. math:: blocks, so thismath may contain line breaks. If it does, we put the math in analigned environment to simulate rst2latex.py's behavior.

• HTML reader:

  • Fix col width parsing for percentages < 10% (#4262, n3fariox).

• LaTeX reader:

  • Advance source position at end of stream.
  • Pass through macro defs in rawLaTeXBlock even if the latex_macrosextension is set (#4246). This reverts to earlier behavior and isprobably safer on the whole, since some macros only modify things inincluded packages, which pandoc's macro expansion can't modify.
  • Fixed pos calculation in tokenizing escaped space.
  • Allow macro definitions inside macros (#4253). Previously we went intoan infinite loop with

    \newcommand{\noop}[1]{#1}\noop{\newcommand{\foo}[1]{#1}}\foo{hi}

  • Fix inconsistent column widths (#4238). This fixes a bug whereby columnwidths for the body were different from widths for the header in sometables.

• Docx reader (Jesse Rosenthal):

  • Parse hyperlinks in instrText tags (#3389, #4266). This was a form ofhyperlink found in older versions of word. The changes introduced forthis, though, create a framework for parsing further fields in MS Word(see the spec, ECMA-376-1:2016, §17.16.5, for more on these fields).We introduce a new module, Text.Pandoc.Readers.Docx.Fields whichcontains a simple parsec parser. At the moment, only simple hyperlinkfields are accepted, but that can be extended in the future.

• Muse reader (Alexander Krotov):

  • Parse ~~ as non-breaking space in Text::Amuse mode.
  • Refactor list parsing.

• Powerpoint writer (Jesse Rosenthal):

  • Change reference to notesSlide to endNotesSlide.
  • Move image sizing into picProps.
  • Improve table placement.
  • Make our own _rels/.rels file.
  • Import reference-doc images properly.
  • Move Presentation.hs out of PandocMonad.
  • Refactor into separate modules. T.P.W.Powerpoint.Presentationdefines the Presentation datatype and goes Pandoc->Presentation;T.P.W.Pandoc.Output goes Presentation->Archive.Text.Pandoc.Writers.Powerpoint a thin wrapper around the two modules.
  • Avoid overlapping blocks in column output.
  • Position images correctly in two-column layout.
  • Make content shape retrieval environment-aware.
  • Improve image handling. We now determine image and caption placementby getting the dimensions of the content box in a given layout.This allows for images to be correctly sized and positioned in adifferent template. Note that images without captions and headers areno longer full-screened. We can't do this dependably in differentlayouts, because we don't know where the header is (it could be tothe side of the content, for example).
  • Read presentation size from reference file. Our presentation size isnow dependent on the reference/template file we use.
  • Handle (sub)headers above slidelevel correctly. Above the slidelevel,subheaders will be printed in bold and given a bit of extra spacebefore them. Note that at the moment, no distinction is made betweenlevels of headers above the slide header, though that can be changed.
  • Check for required files. Since we now import from reference/distfile by glob, we need to make sure that we're getting the files weneed to make a non-corrupt Powerpoint. This performs that check.
  • Improve templating using --reference-doc. Templating should workmuch more reliably now.
  • Include Notes slide in TOC.
  • Set notes slide header to slide-level.
  • Add table of contents. This is triggered by the --toc flag. Notethat in a long slide deck this risks overrunning the text box. The usercan address this by setting --toc-depth=1.
  • Set notes slide number correctly.
  • Clean up adding metadata slide. We want to count the slide numberscorrectly if it's in there.
  • Add anchor links. For anchor-type links ([foo](#bar)) we producean anchor link. In powerpoint these are links to slides, so we keeptrack of a map relating anchors to the slides they occur on.
  • Make the slide number available to the blocks. For anchors,block-processing functions need to know what slide numberthey're in. We make the envCurSlideId available to blocks.
  • Move curSlideId to environment.
  • Allow setting toc-title in metadata.
  • Link notes to endnotes slide.

• Markdown writer:

  • Fix cell width calculation (#4265). Previously we could getever-lengthening cell widths when a table was run repeatedly throughpandoc -f markdown -t markdown.

• LaTeX writer:

  • Escape & in lstinline (Robert Schütz).

• ConTeXt writer:

  • Use xtables instead of Tables (#4223, Henri Menke).Default to xtables for context output. Natural Tables are usedif the new ntb extension is set.

• HTML writer:

  • Fixed footnote backlinks with --id-prefix (#4235).

• Text.Pandoc.Extensions: Added Ext_ntb constructor (API change,Henri Menke).

• Text.Pandoc.ImageSize: add derived Eq instance to Dimension(Jesse Rosenthal, API change).

• Lua filters (Albert Krewinkel):

  • Make PANDOC_READER_OPTIONS available.The options which were used to read the document are made available toLua filters via the PANDOC_READER_OPTIONS global.
  • Add lua module pandoc.utils.run_json_filter, which runs a JSON filteron a Pandoc document.
  • Refactor filter-handling code into Text.Pandoc.Filter.JSON,Text.Pandoc.Filter.Lua, and Text.Pandoc.Filter.Path.
  • Improve error messages. Provide more context about the taskwhich caused an error.

• data/pandoc.lua (Albert Krewinkel):

  • Accept singleton inline as a list. Every constructor which accepts alist of inlines now also accepts a single inline element forconvenience.
  • Accept single block as singleton list. Every constructor which acceptsa list of blocks now also accepts a single block element forconvenience. Furthermore, strings are accepted as shorthand for{pandoc.Str "text"} in constructors.
  • Add attr, listAttributes accessors. Elements withattributes got an additional attr accessor. Attributes wereaccessible only via the identifier, classes, and attributes,which was in conflict with the documentation, which indirectly statesthat such elements have the an attr property.
  • Drop _VERSION. Having a _VERSION became superfluous, as thismodule is closely tied to the pandoc version, which is available viaPANDOC_VERSION.
  • Fix access to Attr components. Accessing an Attr value (e.g., Attr().classes) was broken; the more common case of accessing it viaan Inline or Block element was unaffected by this.

• Move metaValueToInlines to from Docx writer toText.Pandoc.Writers.Shared, so it can be used by other writers(Jesse Rosenthal).

• MANUAL.txt:

  • Clarify otherlangs in LaTeX (#4072).
  • Clarify latex_macros extension.
  • Recommend use of raw_attribute extension in header includes (#4253).

• Allow latest QuickCheck, tasty, criterion.

• Remove custom prelude and ghc 7.8 support.

• Reduce compiler noise (exact paths for compiled modules).

pandoc 2.1 (2018-01-07)

• Allow filters and lua filters to be interspersed (#4196). Previouslywe ran all lua filters before JSON filters. Now we run filters inthe order they are presented on the command line, whether lua or JSON.There are two incompatible API changes: The type of applyFiltershas changed, and applyLuaFilters has been removed. Filter isalso now exported.

• Use latest skylighting and omit the missingIncludes check, fixinga major performance regression in earlier releases of the 2.x series(#4226). Behavior change: If you use a custom syntax definition thatrefers to a syntax you haven't loaded, pandoc will now complain whenit is highlighting the text, rather than doing a check at the start.This change dramatically speeds up invocations of pandoc on shortinputs.

• Text.Pandoc.Class: make FileTree opaque (don't exportFileTree constructor). This forces users to interact with it usinginsertInFileTree and getFileInfo, which normalize file names.

• Markdown reader:

  • Rewrite inlinesInBalancedBrackets. The rewrite is much moredirect, avoiding parseFromString. And it performs significantlybetter; unfortunately, parsing time still increases exponentially(see #1735).
  • Avoid parsing raw tex unless \ + letter seen. This seems tohelp with the performance problem, #4216.

• LaTeX reader: Simplified a check for raw tex command.

• Muse reader (Alexander Krotov):

  • Enable round trip test (#4107).
  • Automatically translate #cover into #cover-image.Amusewiki uses #cover directive to specify cover image.

• Docx reader (Jesse Rosenthal):

  • Allow for insertion/deletion of paragraphs (#3927).If the paragraph has a deleted or inserted paragraph break (dependingon the track-changes setting) we hold onto it until the nextparagraph. This takes care of accept and reject. For this we introducea new state which holds the ils from the previous para if necessary.For --track-changes=all, we add an empty span with classparagraph-insertion/paragraph-deletion at the end of the paragraphprior to the break to be inserted or deleted.
  • Remove unused anchors (#3679). Docx produces a lot of anchors withnothing pointing to them---we now remove these to produce cleaneroutput. Note that this has to occur at the end of the processbecause it has to follow link/anchor rewriting.
  • Read multiple children of w:sdtContents.
  • Combine adjacent anchors. There isn't any reason to have numerousanchors in the same place, since we can't maintain docx'snon-nesting overlapping. So we reduce to a single anchor.
  • Improved tests.

• Muse writer (Alexander Krotov): don't escape URIs from AST

• Docx writer:

  • Removed redundant subtitle in title (Sebastian Talmon).
  • firstRow table definition compatibility for Word 2016 (SebastianTalmon). Word 2016 seems to use a default value of "1" for tableheaders, if there is no firstRow definition (although a defaultvalue of 0 is documented), so all tables get the first Row formattedas header. Setting the parameter to 0 if the table has no headerrow fixes this for Word 2016
  • Fix custom styles with spaces in the name (#3290).

• Powerpoint writer (Jesse Rosenthal):

  • Ignore Notes div for parity with other slide outputs.
  • Set default slidelevel correctly. We had previously defaulted toslideLevel 2. Now we use the correct behavior of defaulting to thehighest level header followed by content. We change an expected testresult to match this behavior.
  • Split blocks correctly for linked images.
  • Combine adjacent runs.
  • Make inline code inherit code size. Previously (a) the code sizewasn't set when we force size, and (b) the properties was set fromthe default, instead of inheriting.
  • Simplify replaceNamedChildren function.
  • Allow linked images. The following markdown:[![Image Title](image.jpg)](http://www.example.com)will now produce a linked image in the resulting PowerPoint file.
  • Fix error with empty table cell. We require an empty <a:p> tag,even if the cell contains no paragraphs---otherwise PowerPointcomplains of corruption.
  • Implement two-column slides. This uses the columns/column divformat described in the pandoc manual. At the moment, only twocolumns (half the screen each) are allowed. Custom widths are notsupported.
  • Added more tests.

• OpenDocument/ODT writers: improved rendering of formulas (#4170, oltolm).

• Lua filters (Albert Krewinkel):

  • data/pandoc.lua: drop 'pandoc-api-version' from Pandoc objects
  • The current pandoc-types version is made available to Lua programs inthe global PANDOC_API_VERSION. It contains the version as a list ofnumbers.
  • The pandoc version available as a global PANDOC_VERSION (a listof numbers).
  • data/pandoc.lua: make Attr an AstElement.
  • data/pandoc.lua: make all types subtypes of AstElement.Pandoc, Meta, and Citation were just plain functions and didnot set a metatable on the returned value, which made it difficultto amend objects of these types with new behavior. They are nowsubtypes of AstElement, meaning that all their objects can gainnew features when a method is added to the behavior object(e.g., pandoc.Pandoc.behavior).
  • data/pandoc.lua: split type and behavior tables. Clearly distinguishbetween a type and the behavioral properties of an instance of thattype. The behavior of a type (and all its subtypes) can now beamended by adding methods to that types behavior object, withoutexposing the type objects internals. E.g.:

    pandoc.Inline.behavior.frob = function () print'42' endlocal str = pandoc.Str'hello'str.frob() -- outputs '42'

  • data/pandoc.lua: fix Element inheritance. Extending all elementsof a given type (e.g., all inline elements) was difficult, as thetable used to lookup unknown methods would be reset every time anew element of that type was created, preventing recursive propertylookup. This is was changed in that all methods and attributes ofsupertypes are now available to their subtypes.
  • data/pandoc.lua: fix attribute names of Citation (#4222). Thefields were named like the Haskell fields, not like the documented,shorter version. The names are changed to match the documentationand Citations are given a shared metatable to enable simpleextensibility.
  • data/pandoc.lua: drop function pandoc.global_filter.
  • Bump hslua version to 0.9.5. This version fixes a bug that made itdifficult to handle failures while getting lists or a Map from Lua.A bug in pandoc, which made it necessary to always pass a tag whenusing MetaList or MetaBlock, is fixed as a result. Using the pandocmodule's constructor functions for these values is now optional(if still recommended).
  • Stop exporting pushPandocModule (API change). The introductionof runPandocLua renders direct use of this function obsolete.
  • Update generation of module docs for lua filters.
  • Lua.Module.Utils: make stringify work on MetaValues (JohnMacFarlane). I'm sure this was intended in the first place,but currently only Meta is supported.

• Improve benchmarks.

  • Set the default extensions properly.
  • Improve benchmark argument parsing. You can now saymake bench BENCHARGS="markdown latex reader" and both themarkdown and latex readers will be benchmarked.

• MANUAL.txt simplify and add more structure (Mauro Bieg).

• Generate README.md from template and MANUAL.txt.make README.md will generate the README.md after changesto MANUAL.txt have been made.

• Update copyright notices to include 2018 (Albert Krewinkel).

pandoc 2.0.6 (2017-12-28)

• Added jats as an input format.

  • Add Text.Pandoc.Readers.JATS, exporting readJATS (APIchange) (Hamish Mackenzie).
  • Improved citation handling in JATS reader. JATS citationsare now converted to pandoc citations, and JATS ref-listsare converted into a references field in metadata, suitablefor use with pandoc-citeproc. Thus a JATS article with embeddedbibliographic information can be processed with pandoc andpandoc-citeproc to produce a formatted bibliography.

• Allow --list-extensions to take an optional FORMAT argument.This lists the extensions set by default for the selected FORMAT.The extensions are now alphabetized, and the + or -indicating the default setting comes before, rather than after,the extension.

• Markdown reader:

  • Preserve original whitespace between blocks.
  • Recognize \placeformula as context.
  • Be pickier about table captions. A caption starts with a : whichcan't be followed by punctuation. Otherwise we can falsely interpretthe start of a fenced div, or even a table header line like:--:|:--:, as a caption.
  • Always use four space rule for example lists. It would be awkwardto indent example list contents to the first non-space character afterthe label, since example list labels are often long. Thanks toBernhard Fisseni for the suggestion.
  • Improve raw tex parsing. Note that the Markdown reader is alsoaffected by the latex_macros extension changes described belowunder the LaTeX reader.

• LaTeX reader:

  • latex_macros extension changes (#4179). Don't pass through macrodefinitions themselves when latex_macros is set. The macroshave already been applied. If latex_macros is enabled, thenrawLaTeXBlock in Text.Pandoc.Readers.LaTeX will succeed in parsinga macro definition, and will update pandoc's internal macro mapaccordingly, but the empty string will be returned.
  • Export tokenize, untokenize (API change).
  • Use applyMacros in rawLaTeXBlock, rawLaTeXInline.
  • Refactored inlineCommand.
  • Fix bug in tokenizer. Material following ^^ wasdropped if it wasn't a character escape. This only affectedinvalid LaTeX, so we didn't see it in the wild, but it appearedin a QuickCheck test failure.
  • Fix regression in LateX tokenization (#4159). This mainly affects theMarkdown reader when parsing raw LaTeX with escaped spaces.
  • Add tests of LaTeX tokenizer.
  • Support \foreignlanguage from babel.
  • Be more tolerant of & character (#4208). This allows us to parseunknown tabular environments as raw LaTeX.

• Muse reader (Alexander Krotov):

  • Parse anchors immediately after headings as IDs.
  • Require that note references does not start with 0.
  • Parse empty comments correctly.

• Org reader (Albert Krewinkel):

  • Fix asterisks-related parsing error (#4180).
  • Support minlevel option for includes (#4154). The level of headersin included files can be shifted to a higher level by specifying aminimum header level via the :minlevel parameter. E.g.#+include: "tour.org" :minlevel 1 will shift the headers intour.org such that the topmost headers become level 1 headers.
  • Break-up org reader test file into multiple modules.

• OPML reader:

  • Enable raw HTML and other extensions by default for notes(#4164). This fixes a regression in 2.0. Note that extensions cannow be individually disabled, e.g. -f opml-smart-raw_html.

• RST reader:

  • Allow empty list items (#4193).
  • More accurate parsing of references (#4156). Previously we erroneouslyincluded the enclosing backticks in a reference ID (#4156). Thischange also disables interpretation of syntax inside references, asin docutils. So, there is no emphasis in `my *link*`_.

• Docx reader:

  • Continue lists after interruption (#4025, Jesse Rosenthal).Docx expects that lists will continue where they left off after aninterruption and introduces a new id if a list is starting again. Sowe keep track of the state of lists and use them to define a "start"attribute, if necessary.
  • Add tests for structured document tags unwrapping (Jesse Rosenthal).
  • Preprocess Document body to unwrap w:sdt elements (Jesse Rosenthal,#4190).

• Plain writer:

  • Don't linkify table of contents.

• RST writer:

  • Fix anchors for headers (#4188). We were missing an _.

• PowerPoint writer (Jesse Rosenthal):

  • Treat lists inside BlockQuotes as lists. We don't yet produceincremental lists in PowerPoint, but we should at least treat listsinside BlockQuotes as lists, for compatibility with other slide formats.
  • Add ability to force size. This replaces the more specificblockQuote runProp, which only affected the size of blockquotes. Wecan use this for notes, etc.
  • Implement notes. This currently prints all notes on a final slide.Note that at the moment, there is a danger of text overflowing thenote slide, since there is no logic for adding further slides.
  • Implement basic definition list functionality to PowerPoint writer.
  • Don't look for default template file for Powerpoint (#4181).
  • Add pptx to isTextFormat list. This is used to check standaloneand not writing to the terminal.
  • Obey slide level option (Jesse Rosenthal).
  • Introduce tests.

• Docx writer:

  • Ensure that distArchive is the one that comes with pandoc(#4182). Previously a reference.docx in ~/.pandoc (or the user datadir) would be used instead, and this could cause problems because auser-modified docx sometimes lacks vital sections that we counton the distArchive to supply.

• Org writer:

  • Do not wrap "-" to avoid accidental bullet lists (Alexander Krotov).
  • Don't allow fn refs to wrap to beginning of line (#4171, with help fromAlexander Krotov). Otherwise they can be interpreted as footnotedefinitions.

• Muse writer (Alexander Krotov):

  • Don't wrap note references to the next line (#4172).

• HTML writer:

  • Use br elements in line blocks instead of relying on CSS(#4162). HTML-based templates have had the custom CSS fordiv.line-block removed. Those maintaining custom templates will wantto remove this too. We still enclose line blocks in a div with classline-block.

• LaTeX writer:

  • Use \renewcommand for \textlatin with babel (#4161).This avoids a clash with a deprecated \textlatin command definedin Babel.
  • Allow fragile=singleslide attribute in beamer slides (#4169).
  • Use \endhead after \toprule in headerless tables (#4207).

• FB2 writer:

  • Add cover image specified by cover-image meta (Alexander Krotov,#4195).

• JATS writer (Hamish Mackenzie):

  • Support writing <fig> and <table-wrap> elementswith <title> and <caption> inside them by using Divs with class setto one of fig, table-wrap or caption (Hamish Mackenzie). Thetitle is included as a Heading so the constraint on where Heading canoccur is also relaxed.
  • Leave out empty alt attributes on links.
  • Deduplicate image mime type code.
  • Make <p> optional in <td> and <th> (#4178).
  • Self closing tags for empty xref (#4187).
  • Improve support for code language.

• Custom writer:

  • Use init file to setup Lua interpreter (Albert Krewinkel).The same init file (data/init) that is used to setup the Luainterpreter for Lua filters is also used to setup the interpreter ofcustom writers.lua.
  • Define instances for newtype wrapper (Albert Krewinkel). The customwriter used its own ToLuaStack instance definitions, which madeit difficult to share code with Lua filters, as this could resultin conflicting instances. A Stringify wrapper is introduced toavoid this problem.
  • Added tests for custom writer.
  • Fixed definition lists and tables in data/sample.lua.

• Fixed regression: when target is PDF, writer extensions were beingignored. So, for example, pandoc -t latex-smart -o file.pdfdid not work properly.

• Lua modules (Albert Krewinkel):

  • Add pandoc.utils module, to hold utility functions.
  • Create a Haskell module Text.Pandoc.Lua.Module.Pandoc todefine the pandoc lua module.
  • Make a Haskell module for each Lua module. Move definitions for thepandoc.mediabag modules to a separate Haskell module.
  • Move sha1 from the main pandoc module to pandoc.utils.
  • Add function pandoc.utils.hierarchicalize (convert list ofPandoc blocks into (hierarchical) list of Elements).
  • Add function pandoc.utils.normalize_date (parses a date andconverts it (if possible) to "YYYY-MM-DD" format).
  • Add function pandoc.utils.to_roman_numeral (allows conversionof numbers below 4000 into roman numerals).
  • Add function pandoc.utils.stringify (converts any AST elementto a string with formatting removed).
  • data/init.lua: load pandoc.utils by default
  • Turn pipe, read into full Haskell functions. The pipe and readutility functions are converted from hybrid lua/haskell functionsinto full Haskell functions. This avoids the need for intermediate_pipe/_read helper functions, which have dropped.
  • pandoc.lua: re-add missing MetaMap function. This was a bugintroduced in version 2.0.4.

• Text.Pandoc.Class: Add insertInFileTree [API change]. This givesa pure way to insert an ersatz file into a FileTree. In addition, wenormalize paths both on insertion and on lookup.

• Text.Pandoc.Shared: export blocksToInlines' (API change, Maura Bieg).

• Text.Pandoc.MIME: Add opus to MIME type table as audio/ogg (#4198).

• Text.Pandoc.Extensions: Alphabetical order constructors forExtension. This makes them appear in order in --list-extensions.

• Allow lenient decoding of latex error logs, which are not alwaysproperly UTF8-encoded (#4200).

• Update latex template to work with recent versions of beamer.The old template produced numbered sections with some recentversions of beamer. Thanks to Thomas Hodgson.

• Updated reference.docx (#4175). Instead of just "Hello, world", thedocument now contains exemplars of most of the styles that have aneffect on pandoc documents. This makes it easier to see the effectof style changes.

• Removed default.theme data file (#4096). It is no longer needed nowthat we have --print-highlight-style.

• Added stack.lts9.yaml for building with lts 9 and ghc 8.0.2.We still need this for the alpine static linux build, sincewe don't have ghc 8.2.2 for that yet.

• Removed stack.pkg.yaml. We only really need stack.yaml; wecan put flag settings for pandoc-citeproc there.

• Makefile: Add 'trypandoc' and 'pandoc-templates' targets tomake releases easier.

• MANUAL.txt:

  • Add note on what formats have +smart by default.
  • Use native syntax for custom-style (#4174, Mauro Bieg).
  • Introduce dedicated Extensions section, since some extensionsaffect formats other than markdown (Mauro Bieg, #4204).
  • Clarify default html output for --section-divs (Richard Edwards).

• filters.md: say that Text.Pandoc.JSON comes form pandoc-types.Closes jgm/pandoc-website#16.

• epub.md: Delete removed -S option from command (#4151, Georger Araújo).

pandoc 2.0.5 (2017-12-12)

• Fix a bug in 2.0.4, whereby pandoc could not read the theme filesgenerated with --print-highlight-style (#4133). Improve JSONserialization of styles.

• Fix CSS issues involving line numbers (#4128).Highlighted code blocks are now enclosed in a div with class sourceCode.Highlighting CSS no longer sets a generic color for pre and code; we onlyset these for class sourceCode.

• --pdf-engine-opt: fix bug where option order was reversed (#4137).

• Add PowerPoint (pptx) writer (Jesse Rosenthal).It works following the standard Pandoc conventions for making othersorts of slides. Caveats:

  • Syntax highlighting is not yet implemented. (This is difficultbecause there are no character classes in Powerpoint.)
  • Footnotes and Definition lists are not yet implemented. (Notes willusually take the form of a final slide.
  • Image placement and auto-resizing has a few glitches.
  • Reference powerpoint files don't work dependably from the commandline. This will be implemented, but at the moment users are advisedto change themes from within Powerpoint.

• Create shared Text.Pandoc.Writers.OOXML module (Jesse Rosenthal).This is for functions used by both Powerpoint and Docx writers.

• Add default pptx data for Powerpoint writer (Jesse Rosenthal).

• Add empty_paragraphs extension.

  • Deprecate --strip-empty-paragraphs option. Instead we nowuse an empty_paragraphs extension that can be enabled onthe reader or writer. By default, disabled.
  • Add Ext_empty_paragraphs constructor to Extension.
  • Revert "Docx reader: don't strip out empty paragraphs."This reverts commit d6c58eb836f033a48955796de4d9ffb3b30e297b.
  • Implement empty_paragraphs extension in docx reader and writer,opendocument writer, html reader and writer.
  • Add tests for empty_paragraphs extension.

• Markdown reader:

  • Don't parse native div as table caption (#4119).
  • Improved computation of column widths in pipe tables.Pipe tables with lines longer than the text width (as setby --columns) are now scaled to text width, with the relativewidths of columns determined by the ratios between theheader lines. Previously we computed column widths usingthe ratio of header line lengths to column width, so thattables with narrow header lines were extremely thin, whichwas very rarely the desired result.

• LaTeX reader: fix \ before newline (#4134). This should be a space,as long as it's not followed by a blank line. This has been fixed at thetokenizer level.

• Muse reader (Alexander Krotov):

  • Add test for #disable-tables directive in Emacs mode.
  • Don't allow emphasis to be preceded by letter.
  • Add underline support in Emacs Muse mode..
  • Support multiline directives in Amusewiki mode

• Man writer: omit internal links (#4136). That is, just print the linktext without the URL.

• Markdown reader: accept processing instructions as raw HTML (#4125).

• Lua filters (Albert Krewinkel):

  • Use script to initialize the interpreter. The file init.lua isused to initialize the Lua interpreter which is used in Lua filters.This gives users the option to require libraries which they want touse in all of their filters, and to extend default modules.
  • Fix package loading for Lua 5.1. The list of package searchers isnamed package.loaders in Lua 5.1 and LuaJIT, and package.searchersin Lua 5.2 and later.
  • Refactor lua module handling. The integration with Lua's package/modulesystem is improved: A pandoc-specific package searcher is prepended tothe searchers in package.searchers. The modules pandoc andpandoc.mediabag can now be loaded via require.
  • Bump lower bound of hslua. The release hslua 0.9.3 contains a newfunction which makes using Haskell functions as package loaders mucheasier.

• reveal.js template: add title-slide identifier to title slide (#4120).This allows it to be styled more easily.

• LaTeX template: Added support for pagestyle variable (#4135,Thomas Hodgson)

• Add -threaded to ghc-options for executable (#4130, fixes a builderror on linux).

pandoc 2.0.4 (2017-12-03)

• Add --print-highlight-style option. This generates a JSON versionof a highlighting style, which can be saved as a .theme file, modified,and used with --highlight-style (#4106, #4096).

• Add --strip-empty-paragraphs option. This works for any input format.It is primarily intended for use with docx and odt documents whereempty paragraphs have been used for inter-paragraph spaces.

• Support --webtex for gfm output.

• Recognize .muse file extension.

• Support beamer \alert in LaTeX reader. Closes #4091.

• Docx reader: don't strip out empty paragraphs (#2252).Users who have a conversion pipeline from docx may want to consider adding--strip-empty-paragraphs to the command line.

• Org reader (Albert Krewinkel): Allow empty list items (#4090).

• Muse reader (Alexander Krotov):

  • Parse markup in definition list terms.
  • Allow definition to end with EOF.
  • Make code blocks round trip.
  • Drop common space prefix from list items.
  • Add partial round trip test.
  • Don't interpret XML entities.
  • Remove nested.
  • Parse ~~ as non-breaking space in Emacs mode.
  • Correctly remove indentation from notes. Exactly one space isrequired and considered to be part of the marker.
  • Allow list items to be empty.
  • Add ordered list test.
  • Add more multiline definition tests.
  • Don't allow blockquotes within lists.
  • Fix reading of multiline definitions.
  • Add inline <literal> support.
  • Concatenate inlines of the same type

• Docx writer: allow empty paragraphs (#2252).

• CommonMark/gfm writer:

  • Use raw html for native divs/spans (#4113). This allows a pandocmarkdown native div or span to be rendered in gfm using raw html tags.
  • Implement raw_html and raw_tex extensions. Note that raw_htmlis enabled by default for gfm, while raw_tex is disabled by default.

• Muse writer (Alexander Krotov):

  • Test that inline math conversion result is normalized.Without normalization this test produced<em>a</em><em>b</em><em>c</em>.
  • Improve inline list normalization and move to writer.
  • Escape hash symbol.
  • Escape ---- to avoid accidental horizontal rules.
  • Escape only </code> inside code tag.
  • Additional <verbatim> is not needed as <code> is verbatim already.

• LaTeX writer:

  • Allow specifying just width or height for image size.Previously both needed to be specified (unless the image wasbeing resized to be smaller than its original size).If height but not width is specified, we now set width totextwidth. If width but not height is specified, we now setheight to textheight. Since we have keepaspectratio, thisyields the desired result.
  • Escape ~ and _ in code with --listings (#4111).

• HTML writer: export tagWithAttributes. This is a helper allowingother writers to create single HTML tags.

• Let papersizes a0, a1, a2, ... be case-insensitive byconverting the case as needed in LaTeX and ConTeXt writers.

• Change fixDisplayMath from Text.Pandoc.Writers.Sharedso that it no longer produces empty Para's as an artifact.

• Text.Pandoc.Shared.blocksToInlines: rewrote using builder.This gives us automatic normalization, so we don't getfor example two consecutive Spaces.

• Include default CSS for 'underline' class in HTML-based templates.

• revealjs template: add tex2jax configuration for themath plugin. With the next release of reveal.js, this willfix the problem of $s outside of math contexts beinginterpreted as math delimiters (#4027).

• pandoc.lua module for use in lua filters (Albert Krewinkel):

  • Add basic lua List module (#4099, #4081). The List module isautomatically loaded, but not assigned to a global variable. It can beincluded in filters by calling List = require 'List'. Lists of blocks,lists of inlines, and lists of classes are now given List as a metatable,making working with them more convenient. E.g., it is now possible toconcatenate lists of inlines using Lua's concatenation operator ..(requires at least one of the operants to have List as a metatable):

    function Emph (emph) local s = {pandoc.Space(), pandoc.Str 'emphasized'} return pandoc.Span(emph.content .. s)end

    The List metatable is assigned to the tables which get passed tothe constructors MetaBlocks, MetaInline, and MetaList. Thisenables the use of the resulting objects as lists.

  • Lua/StackInstances: push Pandoc and Meta via constructor.Pandoc and Meta elements are now pushed by calling the respectiveconstructor functions of the pandoc Lua module. This makes serializationconsistent with the way blocks and inlines are pushed to lua and allowsto use List methods with the blocks value.

  • Add documentation for pandoc.List in lua-filters.md.

• Use latest tagsoup. This fixes a bug in parsing HTML tags with& (but not a valid entity) following them (#4094, #4088).

• Use skylighting 0.4.4.1, fixing the color of unmarked code textwhen numberLines is used (#4103).

• Make normalizeDate more forgiving (Mauro Bieg, #4101), notrequiring a leading 0 on single-digit days.

• Fix --help output for --highlight-style to include FILE (MauroBieg, #4095).

• Clearer deprecation warning for --latexmathml, --asciimathml, -m.Previously we only mentioned --latexmathml, even if -m wasused.

• Changelog: fix description of lua filters in 2.0 release(Albert Krewinkel). Lua filters were initially run after conventional(JSON) filters. However, this was changed later to make it easier to dealwith files in the mediabag. The changelog is updated to describe thatfeature of the 2.0 release correctly.

• Change Generic JSON instances to TemplateHaskell (Jasper Van der Jeugt,#4085). This reduces compile time and memory usage significantly.

• lua-filters.md: Added tikz filter example.

• Create alternative zip file for macOS binaries.

• Create alternative zip file for Windows binaries.

• Update INSTALL.md since we now provide zips for binaries.

• Relax http-types dependency (Justus Sagemüller, #4084).

• Add epub.md, getting-started.md to docs. These used to live inthe website repo.

• Add packages target to Makefile.

• Bump bounds for binary, http-types, tasty-hunit

pandoc 2.0.3 (2017-11-20)

• Lua filters: preload text module (Albert Krewinkel, #4077).The text module is preloaded in lua. The module contains some UTF-8aware string functions, implemented in Haskell. The module is loaded onrequest only, e.g.:

  text = require 'text'function Str (s) s.text = text.upper(s.text) return send

• Allow table-like access to attributes in lua filters (Albert Krewinkel,#4071). Attribute lists are represented as associative lists in Lua. Pureassociative lists are awkward to work with. A metatable is attached toattribute lists, allowing to access and use the associative list as ifthe attributes were stored in as normal key-value pair in table.Note that this changes the way pairs works on attribute lists. Insteadof producing integer keys and two-element tables, the resulting iteratorfunction now returns the key and value of those pairs. Use ipairs toget the old behavior. Warning: the new iteration mechanism only works ifpandoc has been compiled with Lua 5.2 or later (current default: 5.3).

• Text.Pandoc.Parsing.uri: allow & and = as word characters (#4068).This fixes a bug where pandoc would stop parsing a URI with anempty attribute: for example, &a=&b= wolud stop at a.(The uri parser tries to guess which punctuation charactersare part of the URI and which might be punctuation after it.)

• Introduce HasSyntaxExtensions typeclass (Alexander Krotov, #4074).

  • Added new HasSyntaxExtensions typeclass for ReaderOptions andWriterOptions.
  • Reimplemented isEnabled function from Options.hs to accept bothReaderOptions and WriterOptions.
  • Replaced enabled from CommonMark.hs with new isEnabled.

• Add amuse extension (Alexander Krotov) to enable Amuse wikibehavior for muse. New Ext_amuse constructor forExtension. Note: this is switched on by default; forEmacs behavior, use muse-amuse.

• Muse reader (Alexander Krotov):

  • Count only one space as part of list item marker.
  • Produce SoftBreaks on newlines. Now wrapping can be preservedwith --wrap=preserve.
  • Add Text::Amuse footnote extensions. Footnote end is indicated byindentation, so footnotes can be placed anywhere in the text,not just at the end of it.
  • Accept Emacs Muse definition lists when -amuse.Emacs Muse does not require indentation.

• HTML reader:

  • Ensure we don't produce level 0 headers (#4076), even for chaptersections in epubs. This causes problems because writers aren't setup to expect these.
  • Allow spaces after \( and before \) with tex_math_single_backslash.Previously \( \frac{1}{a} < \frac{1}{b} \) was not parsed as math inmarkdown or html +tex_math_single_backslash.

• MANUAL: clarify that math extensions work with HTML.Clarify that tex_math_dollars and tex_math_single_backslashwill work with HTML as well as Markdown.

• Creole reader: Fix performance issue for longer lists (Sascha Wilde,#4067).

• RST reader: better support for 'container' directive (#4066).Create a div, incorporate name attribute and classes.

• LaTeX reader:

  • Support column specs like *{2}{r} (#4056). This is equivalent torr. We now expand it like a macro.
  • Allow optional args for parbox (#4056).
  • Allow optional arguments on \footnote (#4062).

• EPUB writer: Fixed path for cover image (#4069). It was previouslymedia/media/imagename, and should have been media/imagename.

• Markdown writer: fix bug with doubled footnotes in grid tables(#4061).

• LaTeX template: include natbib/biblatex after polyglossia (#4073).Otherwise we seem to get an error; biblatex wants polyglossialanguage to be defined.

• Added examples to lua filters documentation.

pandoc 2.0.2 (2017-11-12)

• Deprecated ancient HTML math methods: --latexmathml, --gladtex,--mimetex, --jsmath.

• Fixed URIs in data/jats.csl. They were being rendered twice,leading to invalid XML in default JATS output with pandoc-citeproc.

• lua-filters.md: use real-world man page filter as example.

• Add lua filter functions walk_inline and walk_blockin the pandoc module, to apply filters inside particularinline and block elements.

• Refactored some code from Text.Pandoc.Lua.PandocModuleinto new internal module Text.Pandoc.Lua.Filter.

• Markdown reader:

  • Allow fenced code blocks to be indented 1-3 spaces (#4011).This brings our handling of them into alignment with CommonMark's.
  • Fix YAML metadata with "chomp" (|-). Previously if aYAML block under |- contained a blank line, pandoc wouldnot parse it as metadata.

• Removed etc. from abbreviations file. Often etc. ends asentence, and we want the period to be treated as asentence-ending period.

• Fix regression with --metadata (#4054). Values specified with--metadata should replace a metadata value set in the documentit*elf, rather than creating a list including a new value.

• EPUB writer:

  • Fix EPUB OCF structure. #3720 had been improperly implemented.
  • Fix modified paths for raw HTML tags (src, poster, etc.)(#4050, #4055). This had not been updated for the new EPUBcontainer layout, with a separate text/ subdirectory.
  • Fix image paths with empty --epub-subdirectory.

• Miscellaneous code cleanup (Alexander Krotov).

• Use pandoc-types 1.17.3, which adds Walkable instancesfor [Block] Block and [Inline] Inline.

• Remove obsolete stack.full.yaml (#4052).

• Change to using pandoc-citeproc 0.12.1 in binary packages.

• Consolidate math output method documentation (#4049, Mauro Bieg).

• MANUAL.txt: fix header level of "Extension: emoji" (Albert Krewinkel).

• Use lua filter to generate man page from MANUAL.txt, replacing oldHaskell filters. This is easier and faster.

• Improved INSTALL.md.

• Update commands to extract deb archive on Linux (#4043, Salim B).

pandoc 2.0.1.1 (2017-11-04)

• Improved fix to #3989 (parsing of HTML tags containing> in an attribute or comment). The previous fix (in 2.0.1) onlyworked in certain cases.

• FB2 writer (Alexander Krotov):

  • Add unrecognised genre to <title-info>(Alexander Krotov). XML schema requires at least one genre.
  • Remove <annotation> from <body>.

• CommonMark writer: fix strikethrough for gfm (#4038).

• Use texmath 0.10, which adds support for a wider range ofsymbols and fixes default column alignments in MathMLand OMML.

• Highlighting fixes, using skylighting 0.4.3.2:

  • Fix invalid CSS.
  • Support lineAnchors (or line-anchors) in HTML code blocks.
  • Ensure that code lines don't get duplicate identifiers (#4031).The line identifiers are built using the code block's identifieras a prefix. If the code block has null identifier, we usecb1, cb2, etc.

• Added a few abbreviations to data/abbreviations,and sorted the list (#3984, Wandmalfarbe).

• Improved support for columns in HTML writer (#4028).

  • Remove width attribute from the div.
  • Remove space between <div class="column"> elements,since this prevents columns whose widths sum to 100%(the space takes up space).
  • Move as much as possible of the CSS to the template.
  • Ensure that all the HTML-based templates (including epub)contain the CSS for columns.
  • Columns default to 50% width unless they are given a widthattribute. So if you want two equal-width columns, youcan use a div with class column and no width attribute.

• SelfContained: use base64 for css links with media attribute (#4026).This fixes --self-contained with S5.

• Improve pandoc-template-mode.el (Vaclav Haisman).

• INSTALL.md: MacOS instructions needed xar -f (adam234).

• MANUAL.txt:

  • Clarify that --setext-headers doesn't affect gfm output (#4035).
  • Clarify what is needed to open and close a div in fenced_divs(#4039, Tristano Ajmone).
  • Removed reference to default.beamer in docs (#4024).Also added mention of other templates affecting PDF outputwith different settings.

pandoc 2.0.1 (2017-10-31)

• Fixed regression in parsing of HTML comments in markdown and othernon-HTML formats (Text.Pandoc.Readers.HTML.htmlTag) (#4019).The parser stopped at the first > character, even if it wasn'tthe end of the comment.

• Creole reader (Sascha Wilde):

  • Fix some minor typos and formatting.
  • Add additional test on nowiki-block after para.
  • Fix lists with trailing white space.

• LaTeX reader: handle % comment right after command.For example, \emph%.

• Markdown reader: make sure fenced div closers work in lists.Previously the following failed:

  ::: {.class}1. one2. two:::

  and you needed a blank line before the closing :::.

• Make fenced_divs affect the Markdown writer. If fenced_divs isenabled, Divs will be rendered as fenced divs.

• LaTeX/Beamer writer: support "blocks" inside columns and other Divs(#4016).

• HTML Writer: consistently use dashed class-names (Mauro Bieg, #3556).Note: this change may require some changes in CSS rules.footnoteRef has become footnote-ref, titleslide hasbecome title-slide, and footnoteBack has become footnote-back.

• JATS writer: Properly pass through author metadata (#4020).

• FB2 writer (Alexander Krotov):

  • Write blocks outside of <p> in definitions.
  • Make bullet lists consistent with ordered lists, repeatingthe marker for the outer list rather than indenting sublists,since indentation does not work in readers.
  • Add new style FB2 tests.

• Text.Pandoc.ImageSize: Add Millimeter constructor to Dimension(#4012) [API change]. Now sizes given in 'mm' are no longer convertedto 'cm'.

• Revise documentation of small caps syntax (Andrew Dunning, #4013).

• Fix broken reference links in manual (Andrew Dunning, #4014)

• Fixed example of slide columns structure in changelog (#4015).Also documented this feature in MANUAL.txt.

pandoc 2.0.0.1 (2017-10-30)

• EPUB writer:

  • Fixed filepaths for nonstandard epub-subdirectory values.
  • Ensure that epub2 is recognized as a non-text format,so that a template is used.
  • Don't include "prefix" attribute for ibooks for epub2.It doesn't validate.
  • Fix stylesheet paths; previously we had an incorrectstylesheet path for the cover page and nav page.

• LaTeX reader:

  • Insert space when needed in macro expansion (#4007).Sometimes we need to insert a space after a control sequenceto prevent it merging with a following letter.
  • Allow unbraced arguments for macros (#4007).
  • Allow body of macro definition to be unbraced (#4007).

• Linux package build: ensure that pandoc-citeproc is statically linked.

• trypandoc: add native, ms.

pandoc 2.0 (2017-10-29)

New features

• New output format ms (groff ms). Complete support, includingtables, math, syntax highlighting, and PDF bookmarks. The writer usestexmath's new eqn writer to convert math to eqn format, so a ms fileproduced with this writer should be processed with groff -ms -e ifit contains math.

• New output format jats (Journal Article Tag Suite). This is an XMLformat used in archiving and publishing articles. Note that aURI-encoded CSL stylesheet (data/jats.csl) is added automaticallyunless a stylesheet is specified using --css.

• New output format gfm (GitHub-flavored CommonMark) (#3841).This uses bindings to GitHub's fork of cmark, so it should parsegfm exactly as GitHub does (excepting certain postprocessingsteps, involving notifications, emojis, etc.). markdown_githubhas been deprecated in favor of gfm.

• New output format muse (Emacs Muse) (Alexander Krotov, #3489).

• New input format gfm (GitHub-flavored CommonMark) (#3841).This uses bindings to GitHub's fork of cmark. markdown_githubhas been deprecated in favor of gfm.

• New input format muse (Emacs Muse) reader (Alexander Krotov, #3620).

• New input format tikiwiki (TikiWiki markup) (rlpowell, #3800).

• New input format vimwiki (Vimwiki markup) (Yuchen Pei, #3705).Note that there is a new data file, data/vimwiki.css, which canbe used to display the HTML produced by this reader andpandoc's HTML writer in the style of vimwiki's own HTMLexport.

• New input format creole (Creole 1.0) (#3994, Sascha Wilde).

• New syntax for Divs, with fenced_divs extension enabled bydefault (#168). This gives an attractive, plain-text way to createcontainers for block-level content.

• Added new syntax for including raw content in any output format,enabled by the raw_attribute extension (which is on by defaultfor markdown and multimarkdown). The syntax is the same asfor fenced code blocks or code inlines, only with {=FORMAT} forattributes, where FORMAT is the name of the output format(e.g., ms, html).

• Implement multicolumn support for slide formats (#1710).The structure expected is:

  :::::::::::::: {.columns}::: {.column width="40%"}contents...:::::: {.column width="60%"}contents...:::::::::::::::::

  Support has been added for beamer and all HTML slide formats.

• Allows line comments in templates, beginning with $-- (#3806).(Requires doctemplates 0.2.1.)

• Add --eol=crlf|lf|native flag and writer option to control line endings(Stefan Dresselhaus, #3663, #2097).

• Add --log option to save log messages in JSON format to a file (#3392).

• Add --request-header option, to set request headers when pandocmakes HTTP requests to fetch external resources. For example:--request-header User-Agent:blah.

• Added lua filters (Albert Krewinkel, #3514). The new --lua-filteroption works like --filter but takes pathnames of special lua filtersand uses the lua interpreter baked into pandoc, so that no externalinterpreter is needed. Note that lua filters are all applied afterregular filters, regardless of their position on the command line.For documentation of lua filters, see doc/lua-filters.md.

• Set PANDOC_READER_OPTIONS in environment where filters are run.This contains a JSON representation of ReaderOptions, so filterscan access it.

• Support creation of pdf via groff ms and pdfroff.pandoc -t ms -o output.pdf input.txt.

• Support for PDF generation via HTML and weasyprint or prince(Mauro Bieg, #3909). pandoc -t html5 -o output.pdf --pdf-engine=prince.

• Added --epub-subdirectory option (#3720). This specifies thesubdirectory in the OCF container that holds the EPUB specific content.We now put all EPUB related content in an EPUB/ subdirectory by default(later this will be configurable).

   mimetype META-INF/ com.apple.ibooks.display-options.xml container.xml EPUB/ <<--configurable-->> fonts/ <<--static-->> font.otf media/ <<--static-->> cover.jpg fig1.jpg styles/ <<--static-->> stylesheet.css content.opf toc.ncx text/ <<--static-->> ch001.xhtml

• Added --resource-path=SEARCHPATH command line option (#852).SEARCHPATH is separated by the usual character, depending on OS(: on unix, ; on windows). Default resource path is just workingdirectory. However, the working directory must be explicitlyspecified if the --resource-path option is used.

• Added --abbreviations=FILE option for custom abbreviations file(#256). Dfault abbreviations file (data/abbreviations) containsa list of strings that will be recognized by pandoc'sMarkdown parser as abbreviations. (A nonbreaking space willbe inserted after the period, preventing a sentence space informats like LaTeX.) Users can override the default by putting a fileabbreviations in their user data directory (~/.pandoc on *nix).

• Allow a theme file as argument to --highlight-style.Also include a sample, default.theme, in data/.

• Allow --syntax-definition option for dynamic loading of syntaxhighlighting definitions (#3334).

• Lists in markdown by default now use the CommonMark variablenesting rules (#3511). The indentation required for a block-levelitem to be included in a list item is no longer fixed, but isdetermined by the first line of the list item. To be included inthe list item, a block must be indented to the level of the firstnon-space content after the list marker. Exception: if are 5 or morespaces after the list marker, then the content is interpreted as anindented code block, and continuation paragraphs must be indentedtwo spaces beyond the end of the list marker. See the CommonMarkspec for more details and examples.

  Documents that adhere to the four-space rule should, in most cases,be parsed the same way by the new rules. Here are some examplesof texts that will be parsed differently:

  - a - b

  will be parsed as a list item with a sublist; under the four-spacerule, it would be a list with two items.

  - a code

  Here we have an indented code block under the list item, even though itis only indented six spaces from the margin, because it is four spacespast the point where a continuation paragraph could begin. With thefour-space rule, this would be a regular paragraph rather than a codeblock.

  - a code

  Here the code block will start with two spaces, whereas underthe four-space rule, it would start with code. With the four-spacerule, indented code under a list item always must be indented eightspaces from the margin, while the new rules require only that itbe indented four spaces from the beginning of the first non-spacetext after the list marker (here, a).

  This change was motivated by a slew of bug reports from peoplewho expected lists to work differently (#3125, #2367, #2575, #2210,#1990, #1137, #744, #172, #137, #128) and by the growing prevalanceof CommonMark (now used by GitHub, for example). Those whoprefer the old behavior can use -f markdown+four_space_rule.

• Added four_space_rule extension. This triggers the old pandocparsing rule for content nested under list items (the "four spacerule").

• Added spaced_reference_links extension (#2602). It allows whitespacebetween the two parts of a reference link: e.g.

  [a] [b][b]: url

  This was previously enabled by default; now it is forbidden by default.

• Add space_in_atx_header extension (#3512). This is enabled by defaultin pandoc and GitHub markdown but not the other flavors.This requirse a space between the opening #'s and the headertext in ATX headers (as CommonMark does but many other implementationsdo not). This is desirable to avoid falsely capturing things ilke

  #hashtag

  or

  #5

• Add sourcefile and outputfile template variables (Roland Hieber,#3431).

• Allow ibooks-specific metadata in epubs (#2693). You can now havethe following fields in your YAML metadata, and it will be treatedappropriately in the generated EPUB:

   ibooks: version: 1.3.4 specified-fonts: false ipad-orientation-lock: portrait-only iphone-orientation-lock: landscape-only binding: true scroll-axis: vertical

Behavior changes

• Reader functions no longer presuppose that CRs have beenstripped from the input. (They strip CRs themselves, beforeparsing, to simplify the parsers.)

• Added support for translations (localization) (#3559).Currently this only affects the LaTeX reader, for thingslike \figurename. Translation data files for 46 languagescan be found in data/translations.

• Make --ascii work with DocBook output too.

• Rename --latex-engine to --pdf-engine,and --latex-engine-opt to --pdf-engine-opt.

• Removed --parse-raw and readerParseRaw. These were confusing.Now we rely on the +raw_tex or +raw_html extension with latex or htmlinput. Thus, instead of --parse-raw -f latex we use -f latex+raw_tex,and instead of --parse-raw -f html we use -f html+raw_html.

• With --filter R filters are now recognized, even if they arenot executable (#3940, #3941, Andrie de Vries).

• Support SVG in PDF output, converting with rsvg2pdf (#1793).

• Make epub an alias for epub3, not epub2.

• Removed --epub-stylesheet; use --css instead (#3472, #847).Multiple stylesheets may be used. Stylesheets will be taken both from--css and from the stylesheet metadata field (which can containeither a file path or a list of them).

• --mathml and MathML in HTMLMathMethod no longer take an argument.The argument was for a bridge JavaScript that used to be necessaryin 2004. We have removed the script already.

• --katex improvements. The latest version is used, and theautoload script is loaded by default.

• Change MathJax CDN default since old one is shutting down (#3544).Note: The new URL requires a version number, which we'll haveto update manually in subsequent pandoc releases in order totake advantage of mathjax improvements.

• --self-contained: don't incorporate elements with data-external="1"(#2656). You can leave an external link as it is by adding the attributedata-external="1" to the element. Pandoc will then not try toincorporate its content when --self-contained is used. This issimilar to a feature already supported by the EPUB writer.

• Allow --extract-media to work with non-binary input formats(#1583, #2289). If --extract-media is supplied with a non-binaryinput format, pandoc will attempt to extract the contents of alllinked images, whether in local files, data: uris, or external uris.They will be named based on the sha1 hash of the contents.

• Make papersize: a4 work regardless of the case of a4.It is converted to a4 in LaTeX and A4 in ConTeXt.

• Make east_asian_line_breaks affect all readers/writers (#3703).

• Underlined elements are now treated consistently by readers(#2270, hftf); they are always put in a Span with class underline.This allows the user to treat them differently from other emphasis,using a filter. Docx, Org, Textile, Txt2Tags, and HTML readershave been changed.

• Improved behavior of auto_identifiers when there are explicit ids(#1745). Previously only autogenerated ids were added to the listof header identifiers in state, so explicit ids weren't takeninto account when generating unique identifiers. Duplicatedidentifiers could result. This simple fix ensures that explicitly givenidentifiers are also taken into account.

• Use table-of-contents for contents of toc, make toc a boolean(#2872). Changed markdown, rtf, and HTML-based templates accordingly.This allows you to set toc: true in the metadata; thispreviously produced strange results in some output formats.For backwards compatibility, toc is still set to thetoc contents. But it is recommended that you update templatesto use table-of-contents for the toc contents and tocfor a boolean flag.

• Change behavior with binary format output to stdout.Previously, for binary formats, output to stdout was disabledunless we could detect that the output was being piped (and notsent to the terminal). Unfortunately, such detection is notpossible on Windows, leaving windows users no way to pipe binaryoutput. So we have changed the behavior in the following way:

  • Output to stdout is allowed when it can be determined thatthe output is being piped (on non-Windows platforms).
  • If the -o option is not used, binary output is never sentto stdout by default; instead, an error is raised.
  • If -o - is used, binary output is sent to stdout, regardlessof whether it is being piped. This works on Windows too.

• Better error behavior: uses of error have been replaced byraising of PandocError, which can be trapped and handled by thecalling program.

• Removed hard_line_breaks extension from markdown_github (#3594).GitHub has two Markdown modes, one for long-form documents like READMEsand one for short things like issue coments. In issue comments, a linebreak is treated as a hard line break. In README, wikis, etc., it istreated as a space as in regular Markdown. Since pandoc is more likely tobe used to convert long-form documents from GitHub Markdown,-hard_line_breaks is a better default.

• Include backtick_code_blocks extension in mardkown_mmd (#3637).

• Escape MetaString values (as added with -M/--metadata flag) (#3792).Previously they would be transmitted to the template without anyescaping. Note that --M title='*foo*' yields a different result from

  ---title: *foo*---

  In the latter case, we have emphasis; in the former case, justa string with literal asterisks (which will be escapedin formats, like Markdown, that require it).

• Allow em, cm, in for image height/width in HTML, LaTeX (#3450).

• HTML writer: Insert data- in front of unsupported attributes. Thus,a span with attribute foo gets written to HTML5 with data-foo, soit is valid HTML5. HTML4 is not affected. This will allow us to usecustom attributes in pandoc without producing invalid HTML. (With helpfrom Wandmalfarbe, #3817.)

• Plain writer: improved super/subscript rendering. We nowhandle more non-digit characters for which there aresub/superscripted unicode characters. When unicodesub/superscripted characters are not available, we use_(..) or ^(..) (#3518).

• Docbook, JATS, TEI writers: print INFO message when omitting interiorheader (#3750). This only applies to section headers inside list items,e.g., which were otherwise silently omitted.

• Change to --reference-links in Markdown writer (#3701). With--reference-location of section or block, pandoc will now repeatreferences that have been used in earlier sections. The Markdownreader has also been modified, so that exactly repeated referencesdo not generate a warning, only references with the same label butdifferent targets. The idea is that, with references after every block,one might want to repeat references sometimes.

• ODT/OpenDocument writer:

  • Support lang attribute (#1667).
  • Added support for --toc (#2836). Thanks to @anayrat.

• Docx writer:

  • lang meta, see #1667 (Mauro Bieg, #3515).

  • Change FigureWithCaption to CaptionedFigure (iandol, #3658).

  • Use Table rather than Table Normal for table style (#3275).Table Normal is the default table style and can't be modified.

  • Pass through comments (#2994). We assume that comments are defined asparsed by the docx reader:

    I want I left a comment.some text tohave a comment on it.

    We assume also that the id attributes are unique and properlymatched between comment-start and comment-end.

  • Bookmark improvements. Bookmark start/end now surrounds content ratherthan preceding it. Bookmarks generated for Div with id(jgm/pandoc-citeproc#205).

  • Add keywords metadata to docx document properties (Ian).

• RST writer: support unknown interpreted text roles byparsing them as Span with role attributes (#3407). Thisway they can be manipulated in the AST.

• HTML writer:

  • Line block: Use class instead of style attribute (#1623). We nowissue <div class="line-block"> and include a default definitionfor line-block in the default templates, instead of hard-coding astyle on the div.
  • Add class footnoteBack to footnote back references (Timm Albers).This allows for easier CSS styling.
  • Render SmallCaps as span with smallcaps class (#1592), rather thanusing a style attribute directly. This gives the user more flexibilityin styling small caps in CSS.
  • With reveal.js we use data-src instead of src for images forlazy loading.
  • Special-case .stretch class for images in reveal.js (#1291).Now in reveal.js, an image with class stretch in a paragraphby itself will stretch to fill the whole screen, with nocaption or figure environment.

• Added warnings for non-rendered blocks to writers.

• Writers now raise an error on template failure.

• When creating a PDF via LaTeX, warn if the font is missing somecharacters (#3742).

• Remove initial check for PDF-creating program (#3819).Instead, just try running it and raise the exception if itisn't found at that point. This improves things for users of Cygwinon Windows, where the executable won't be found by findExecutableunless .exe is added. The same exception is raised as before, butat a later point.

• Readers issue warning for duplicate header identifiers (#1745).Autogenerated header identifiers are given suffixes so as not to clashwith previously used header identifiers. But they may still coincide withan explicit identifier that is given for a header later in the document,or with an identifier on a div, span, link, or image. We now issuea warning in this case, so users can supply an explicit identifier.

• CommonMark reader now supports emoji, hard_line_breaks, smart,and raw_html extensions.

• Markdown reader:

  • Don't allow backslash + newline to affect block structure (#3730).Note that as a result of this change, the following, which formerlyproduced a header with two lines separated by a line break, willnow produce a header followed by a paragraph:

    there

    This may affect some existing documents that relied onthis undocumented and unintended behavior. This change makes pandocmore consistent with other Markdown implementations, and with itself(since the two-space version of a line break doesn't work inside ATXheaders, and neither version works inside Setext headers).

• Org reader (Albert Krewinkel, unless noted):

  • Support table.el tables (#3314).
  • Support macros (#3401).
  • Support the #+INCLUDE: file inclusion mechanism (#3510).Recognized include types are example, export, src, andnormal org file inclusion. Advanced features like line numbersand level selection are not implemented yet.
  • Interpret more meta value as inlines. The values of the followingmeta variables are now interpreted using org-markup instead oftreating them as pure strings: keywords (comma-separated list ofinlines), subtitle (inline values), nocite (inline values, canbe repeated).
  • Support \n export option (#3940). This turns all newlines in thetext into hard linebreaks.

• RST reader:

  • Improved admonition support (#223). We no longer add anadmonition class, we just use the class for the type of admonition,note for example. We put the word corresponding to the label ina paragraph inside a Div at the beginning of the admonition withclass admonition-title. This is about as close as we can get toRST's own output.

  • Initial support of .. table directive. This allows adding captionsto tables.

  • Support .. line-block directive. This is deprecated but may stillbe in older documents.

  • Support scale and align attributes of images (#2662).

  • Implemented implicit internal header links (#3475).

  • Support RST-style citations (#853). The citations appear at the endof the document as a definition list in a special div with idcitations. Citations link to the definitions.

  • Recurse into bodies of unknown directives (#3432).In most cases it's better to preserve the content thanto emit it. This isn't guaranteed to have good results;it will fail spectacularly for unknown raw or verbatim directives.

  • Handle chained link definitions (#262). For example,

    .. _hello:.. _goodbye: example.com

    Here both hello and goodbye should link to example.com.

  • Support anchors (#262). E.g.

    `hello`.. _hello:paragraph

    This is supported by putting "paragraph" in a Div with id hello.

  • Support :widths: attribute for table directive.

  • Implement csv-table directive (#3533). Most attributes are supported,including :file: and :url:.

  • Support unknown interpreted text roles by parsing them as Spanwith "role" attributes (#3407). This way they can be manipulated inthe AST.

• HTML reader: parse a span with class smallcaps as SmallCaps.

• LaTeX reader:

  • Implemented \graphicspath (#736).
  • Properly handle column prefixes/suffixes. For example, in\begin{tabular}{>{$}l<{$}>{$}l<{$} >{$}l<{$}}each cell will be interpreted as if it has a $before its content and a $ after (math mode).
  • Handle komascript \dedication (#1845). It now adds adedication field to metadata. It is up to the user to supplya template that uses this variable.
  • Support all \textXX commands, where XX = rm, tt, up, md,sf, bf (#3488). Spans with a class are used when there isnothing better.
  • Expand \newenvironment macros (#987).
  • Add support for LaTeX subfiles package (Marc Schreiber, #3530).
  • Better support for subfigure package (#3577).A figure with two subfigures turns into two pandocfigures; the subcaptions are used and the main captionignored, unless there are no subcaptions.
  • Add support for \vdots (Marc Schreiber, #3607).
  • Add basic support for hyphenat package (Marc Schreiber, #3603).
  • Add basic \textcolor support (Marc Schreiber).
  • Add support for tabularx environment (Marc Schreiber, #3632).
  • Better handling of comments inside math environments (#3113).This solves a problem with commented out \end{eqnarray} insidean eqnarray (among other things).
  • Parse tikzpicture as raw verbatim environment if raw_tex extensionis selected (#3692). Otherwise skip with a warning. This is betterthan trying to parse it as text!
  • Add \colorbox support (Marc Schreiber).
  • Set identifiers on Spans used for \label.
  • Have \setmainlanguage set lang in metadata.
  • Support etoolbox's \ifstrequal.
  • Support plainbreak, fancybreak et al from the memoir class(bucklereed, #3833).
  • Support \let. Also, fix regular macros so they're expanded at thepoint of use, and NOT also the point of definition. \let macros,by contrast, are expanded at the point of definition. Added anExpansionPoint field to Macro to track this difference.
  • Support simple \def macros. Note that we still don't supportmacros with fancy parameter delimiters, like \def\foo#1..#2{...}.
  • Support \chaptername, \partname, \abstractname, etc. (#3559,obsoletes #3560).
  • Put content of \ref, \label, \eqref commands into Span withattributes, so they can be handled in filters (Marc Schreiber, #3639)
  • Add Support for glossaries and acronym package (Marc Schreiber,#3589). Acronyms are not resolved by the reader, but acronym andglossary information is put into attributes on Spans so that theycan be processed in filters.
  • Use Link instead of Span for \ref. This makes more sensesemantically and avoids unnecessary Span [Link] nestings whenreferences are resolved.
  • Rudimentary support for \hyperlink.
  • Support \textquoteleft|right, \textquotedblleft|right (#3849).
  • Support \lq, \rq.
  • Implement \newtoggle, \iftoggle, \toggletrue|false from etoolbox(#3853).
  • Support \RN and \Rn, from biblatex (bucklereed, #3854).
  • Improved support for \hyperlink, \hypertarget (#2549).
  • Support \k ogonek accent.
  • Improve handling of accents. Handle ogonek, and fall back correctlywith forms like \"{}.
  • Better support for ogonek accents.
  • Support for \faCheck and \faClose (Marc Schreiber, #3727).
  • Support for xspace (Marc Schreiber, #3797).
  • Support \setmainlanguage or \setdefaultlanguage (polyglossia)and \figurename.
  • Better handling of \part in LaTeX (#1905). Now we parse chapters aslevel 0 headers, and parts as level -1 headers. After parsing, wecheck for the lowest header level, and if it's less than 1 we bumpeverything up so that 1 is the lowest header level. So \part willalways produce a header; no command-line options are needed.
  • Add block version of \textcolor (Marc Schreiber).
  • \textcolor works as inline and block command (Marc Schreiber).
  • \textcolor will be parse as span at the beginning of a paragraph(Marc Schreiber).
  • Read polyglossia/babel \text(LANG){...} (bucklereed)
  • Improved handling of include files in LaTeX reader (#3971).Previously \include wouldn't work if the included filecontained, e.g., a begin without a matching end.
  • Support \expandafter (#3983).
  • Handle \DeclareRobustCommand (#3983). Currently it's just treatedas a synonym for \newcommand.
  • Handle \lettrine (Mauro Bieg).

• Math improvements due to updates in texmath:

  • Improved handling of accents and upper/lower delimiters.
  • Support for output in GNU eqn format (used with *roff).
  • Allow \boldsymbol + a token without braces, and similarlywith other styling commands.
  • Improve parsing of \mathop to allow multi-character operator names.
  • Add thin space after math operators when "faking it withunicode."

• walk is now used instead of bottomUp in the ToJSONFilterinstance for a -> [a] (pandoc-types). Note that behaviorwill be slightly different, since bottomUp's treatment ofa function [a] -> [a] is to apply it to each sublist of alist, while walk applies it only to maximal sublists.Usually the latter behavior is what is wanted, and theformer can be simulated when needed. But there may beexisting filters that need to be rewritten in light of thenew behavior. Performance should be improved.

• There are some changes to syntax highlighting due to revisionsin the skylighting library:

  • Support for powershell has been added, and many syntaxdefinitions have been updated.
  • Background colors have been added to the kate style.
  • The way highlighted code blocks are formatted in HTML hasbeen changed (David Baynard), in ways that may requirechanges in hard-coded CSS affecting highlighting.(If you haven't included hard-coded highlighting CSS inyour template, you needn't change anything.)

API changes

• New module Text.Pandoc.Class (Jesse Rosenthal, John MacFarlane).This contains definitions of the PandocMonad typeclass, thePandocIO and PandocPure monads, and associated functions.

• Changed types of all writers and readers.

  • We now use Text instead of String in the interface (#3731).(We have not yet changed the internals of most readers to workwith Text, but making this change in the API now opens up apath to doing that.)
  • The result is now of form m a with constraint PandocMonad m.Readers and writers can be combined to form monadic values whichcan be run using either runIO or runPure. If runIO is used,then both readers and writers will be able to do IO when needed(for include files, for example); if runPure is used,then the functions are pure and will not touch IO.
  • Where previously you usedwriteRST def (readMarkdown def "[foo](url)"), now youwould userunPure $ readMarkdown def (pack "[foo](url)") >>= writeRST def.

• New module Text.Pandoc.Readers (Albert Krewinkel). Thiscontains reader helper functions formerly defined in thetop-level Text.Pandoc module.

  • Changed StringReader -> TextReader.
  • getReader now returns a pair of a reader andExtensions, instead of building the extensions into thereader (#3659). The calling code must explicitly setreaderExtensions using the Extensions returned. Thepoint of the change is to make it possible for the callingcode to determine what extensions are being used.

• New module Text.Pandoc.Writers (Albert Krewinkel).This contains writer helper functions formerly defined in thetop-level Text.Pandoc module.

  • Changed StringWriter -> TextWriter.
  • getWriter now retuns a pair of a reader andExtensions, instead of building the extensions into thereader (#3659). The calling code must explicitly setreaderExtensions using the Extensions returned. Thepoint of the change is to make it possible for the callingcode to determine what extensions are being used.

• New module Text.Pandoc.Lua, exporting runLuaFilter (Albert Krewinkel,#3514).

• New module Text.Pandoc.App. This abstracts out the functionalityof the command line program (convertWithOpts), so it can be reproducede.g. in a desktop or web application. Instead of exiting, we throw errors(#3548), which are caught (leading to exit) in pandoc.hs, but allow otherusers of Text.Pandoc.App to recover. pandoc.hs is now a 2-liner.The module also exports some utility functions for parsing optionsand running filters.

• New module Text.Pandoc.Logging (exported module) (#3392).This now contains the Verbosity definition previously inText.Pandoc.Options, as well as a new LogMessage datatype that willeventually be used instead of raw strings for warnings. This will enableus, among other things, to provide machine-readable warnings if desired.Include ToJSON instance and showLogMessage. This gives us the possibilityof both machine-readable and human-readable output for log messages.

• New module Text.Pandoc.BCP47, with getLang, Lang(..), parseBCP47.

• New module Text.Pandoc.Translations, exporting Term,Translations, readTranslations.

• New module Text.Pandoc.Readers.LaTeX.Types', exporting Macro, Tok, TokType, Line, Column`.

• Text.Pandoc.Error: added many new constructors for PandocError.

• Expose some previously private modules (#3260). These are oftenhelpful to people writing their own reader or writer modules:

  • Text.Pandoc.Writers.Shared
  • Text.Pandoc.Parsing
  • Text.Pandoc.Asciify
  • Text.Pandoc.Emoji
  • Text.Pandoc.ImageSize
  • Text.Pandoc.Highlighting`

• New module Text.Pandoc.Extensions (Albert Krewinkel):Extension parsing and processing functions were defined in the top-levelText.Pandoc module. These functions are moved to the Extensionssubmodule as to enable reuse in other submodules.

• Add Ext_raw_attribute constructor for Extension.

• Add Ext_fenced_divs constructor for `Extension'.

• Add Ext_four_space_rule constructor in Extension.

• Add Ext_gfm_auto_identifiers constructor for Extension.

• Add Monoid instance for Extensions.

• Add Text.Pandoc.Writers.Ms, exporting writeMs.

• Add Text.Pandoc.Writers.JATS, exporting writeJATS.

• Add Text.Pandoc.Writers.Muse, exporting writeMuse.

• Add Text.Pandoc.Readers.Muse, exporting readMuse.

• Add Text.Pandoc.Readers.TikiWiki, exporting readTikiWiki.

• Add Text.Pandoc.Readers.Vimwiki, exporting readVimwiki.

• Add Text.Pandoc.Readers.Creole, exporting readCreole.

• Export setVerbosity from Text.Pandoc.

• Text.Pandoc.Pretty: Add Eq instance for Doc.

• Text.Pandoc.XML: toEntities: changed type to Text -> Text.

• Text.Pandoc.UTF8:

  • Export fromText, fromTextLazy, toText, toTextLazy.Define toString, toStringLazy in terms of them.
  • Add new functions parameterized on Newline: writeFileWith,putStrWith, putStrLnWith, hPutStrWith, hPutStrLnWith.

• Text.Pandoc.MediaBag: removed extractMediaBag.

• Text.Pandoc.Highlighting:

  • highlighting now returns an Either rather than Maybe.This allows us to display error information returned by the skylightinglibrary. Display a warning if the highlighting library throws an error.
  • Add parameter for SyntaxMap to highlight.

• Text.Pandoc.Writers.Math:

  • Export defaultMathJaxURL, defaultKaTeXURL. This will ensure thatwe only need to update these in one place.

• Text.Pandoc.SelfContained:

  • Removed WriterOptions parameter from makeSelfContained.
  • Put makeSelfContained in PandocMonad instead of IO. This removesthe need to pass MediaBag around and improves exceptions. It alsoopens up the possibility of using makeSelfContained purely.
  • Export makeDataURI.

• Text.Pandoc.ImageSize:

  • Export lengthToDim, new function scaleDimension.
  • Export inEm from ImageSize (#3450).
  • Change showFl and show instance for Dimension soextra decimal places are omitted.
  • Added Em as a constructor of Dimension.
  • Add WriterOptions parameter to imageSize signature (Mauro Bieg).

• Text.Pandoc.Templates:

  • Change type of renderTemplate'. Now it runs in PandocMonadand raises a proper PandocTemplateError if there are problems, ratherthan failing with uncatchable error.
  • Change signature of getDefaultTemplate. Now it runs in any instanceof PandocMonad, and returns a String rather than an Either value.And it no longer takes a datadir parameter, since this can beretrieved from CommonState.

• Text.Pandoc.Options:

  • Added writerEpubSubdirectory to WriterOptions (#3720).The EPUB writer now takes its EPUB subdirectory from this option.
  • In WriterOptions, rename writerLaTeXEngine to writerPdfEngineand writerLaTeXArgs to writerPdfArgs (Mauro Bieg, #3909).
  • Add writerSyntaxMap to WriterOptions.
  • Removed writerEpubStylesheet from WriterOptions.
  • Remove writerUserDataDir from WriterOptions. It is now carriedin CommonState in PandocMonad instances. (And thus it can be usedby readers too.)
  • Changed writerEpubMetadata to a Maybe String.
  • Removed readerApplyMacros from ReaderOptions. Now we just checkthe latex_macros reader extension.
  • FromJSON/ToJSON instances for ReaderOptions.
  • In HTMLMathMethod, the KaTeX contsructor now takes onlyone string (for the KaTeX base URL), rather than two.
  • Removed writerSourceURL from WriterOptions. We now usestSourceURL in CommonState, which is set by setInputFiles.

• Text.Pandoc.Shared:

  • tabFilter now takes a Text, not String.
  • openURL: Changed type from an Either. Now it will just raisean exception to be trapped later.
  • Remove normalizeSpaces (#1530).
  • Remove warn. (Use report from Text.Pandoc.Class instead.)
  • Export a new function crFilter.
  • Add eastAsianLineBreakFilter (previously in Markdown reader).
  • Provide custom isURI that rejects unknown schemes.(Albert Krewinkel, #2713). We also export the set of knownschemes. The new function replaces the function of the same namefrom Network.URI, as the latter did not check whether a scheme iswell-known. All official IANA schemes (as of 2017-05-22) areincluded in the set of known schemes. The four non-official schemesdoi, isbn, javascript, and pmid are kept.
  • Remove err.
  • Remove readDataFile, readDefaultDataFile, getReferenceDocx,getReferenceODT. These now live in Text.Pandoc.Class,where they are defined in terms of PandocMonadprimitives and have different signatures.
  • Remove openURL. Use openURL from Text.Pandoc.Class instead.
  • Add underlineSpan.

• Text.Pandoc.Readers.HTML: export new NamedTag class.

• Text.Pandoc.Readers.Markdown: remove readDocxWithWarnings.With the new API one can simply use getLog after runningthe reader.

• Text.Pandoc.Readers.LaTeX: Changed types for rawLaTeXInlineand rawLaTeXBlock. (Both now return a String, and they arepolymorphic in state.)

Bug fixes and under-the-hood improvements

• TEI writer: Added identifiers on <div> elements.

• DokuWiki reader: Better handling for code block in list item (#3824).

• Custom writer: Remove old preprocesesor conditionals (Albert Krewinkel).

• ZimWiki writer: Removed internal formatting from note and table cells,because ZimWiki does not support it (Alex Ivkin, #3446).

• MediaWiki writer:

  • Updated list of syntax highlighting languages (#3461).Now r gets you <source> rather than <code> (among others).
  • Add display attribute on <math> tags (#3452). This allows displaymath to be rendered properly.
  • Remove newline before </ref> (#2652).
  • Don't softbreak lines inside list items (#3531).

• Org writer:

  • Reduce to two spaces after bullets (#3417, Albert Krewinkel).
  • Add unit tests (Alexander Krotov).
  • Stop using raw HTML to wrap divs (Albert Krewinkel, #3771).
  • Do not strip # from Org anchor links (Alexander Krotov).

• CommonMark writer:

  • Avoid excess blank lines at end of output.
  • Prefer pipe tables to HTML tables even if it means losing relativecolumn width information (#3734).
  • Support table, strikethrough extensions, when enabled (as with gfm).Note that we bypass the commonmark writer from cmark and construct ourown pipe tables, with better results.
  • Properly support --wrap=none.
  • Use smallcaps class for SmallCaps (#1592).
  • Omit "fig:" prefix in image titles. This is used internally toindicate internal figures.

• RST writer:

  • Properly handle table captions.
  • Don't wrap lines in in definition list terms. Wrapping is not allowed.
  • Implemented +/-smart and improved escaping with +smart.
  • Add empty comments when needed to avoid including a blockquotein the indented content of a preceding block (#3675).
  • Improve grid table output, fix bug with empty rows (#3516).Uses the new gridTable in Writers.Shared, which is hereimproved to better handle 0-width cells.
  • Remove space at beginning/end of RST code span (#3496). Otherwisewe get invalid RST. There seems to be no way to escape the space.
  • Add header anchors when header has non-standard id (#3937).
  • Correctly handle inline code containing backticks, using a :literal:role (#3974).
  • Don't backslash-escape word-internal punctuation (#3978).

• Markdown writer:

  • Don't include variables in metadata blocks. Previously variables seton the command line were included in e.g. YAML metadata, contrary todocumentation and intentions.

  • Improved escaping with +smart.

  • Fixed grid tables embedded in grid tables (#2834).

  • Use span with class 'smallcaps' for SmallCaps, instead of a styleattribute as before (#1592).

  • Escape initial % in a paragraph if the pandoc_title_blocksextension is enabled (#3454). Otherwise in a document starting witha literal % the first line is wrongly interpreted as a title.

  • Fixed false ordered lists in YAML metadata (#3492, #1685). Now weproperly escape things that would otherwise start ordered lists,such as

    ---title: 1. inline...

  • Better handling of tables with empty columns (#3337). We nowcalculate the number of columns based on the longest row (or thelength of aligns or widths).

  • Escape unordered list markers at beginning of paragraph (#3497), toavoid false interpretation as a list.

  • Escape | appropriately.

  • Ensure space before list at top level (#3487).

  • Avoid spurious blanklines at end of document after tables and list,for example.

  • Fixed bugs in simple/multiline list output (#3384).Previously we got overlong lists with --wrap=none. This is fixed.Previously a multiline list could become a simple list (and wouldalways become one with --wrap=none).

  • Don't emit a simple table if simple_tables disabled (#3529).

  • Case-insensitive reference links (David A Roberts, #3616).Ensure that we do not generate reference links whose labels differ onlyby case. Also allow implicit reference links when the linktext and label are identical up to case.

  • Put space before reference link definitions (Mauro Bieg, #3630).

  • Better escaping for links (David A. Roberts, #3619). Previously theMarkdown writer would sometimes create links where there were nonein the source. This is now avoided by selectively escaping bracketcharacters when they occur in a place where a link might be created.

  • Added missing \n (David A. Roberts, #3647).

  • Fixed duplicated reference links with --reference-linksand --reference-location=section (#3674). Also ensure that thereare no empty link references [].

  • Avoid inline surround-marking with empty content (#3715).E.g. we don't want <strong></strong> to become ****.Similarly for emphasis, super/subscript, strikeout.

  • Don't allow soft break in header (#3736).

  • Make sure plain, markdown_github, etc. work for raw.Previously only markdown worked. Note: currently a raw block labeledmarkdown_github will be printed for any markdown format.

  • Ensure that + and - are escaped properly so they don't causespurious lists (#3773). Previously they were onlyif succeeded by a space, not if they were at end of line.

  • Use pipe tables if raw_html disabled and pipe_tables enabled,even if the table has relative width information (#3734).

  • Markdown writer: don't crash on Str "".

  • Make Span with null attribute transparent. That is, we don't usebrackets or <span> tags to mark spans when there are no attributes;we simply output the contents.

  • Escape pipe characters when pipe_tables enabled (#3887).

  • Better escaping of < and >. If all_symbols_escapable is set,we backslash escape these. Otherwise we use entities as before.

  • When writing plain, don't use   to separate list and indentedcode. There's no need for it in this context, since this isn't to beinterpreted using Markdown rules.

  • Preserve classes in JS obfuscated links (Timm Albers, #2989).HTML links containing classes originally now preserve them when usingjavascript email obfuscation.

  • Render SmallCaps as a native span when native_spans are enabled.

  • Always write attributes with bracketed_spans (d-dorazio).

• Man writer:

  • Fix handling of nested font commands (#3568). Previously pandoc emittedincorrect markup for bold + italic, for example, or bold + code.
  • Avoid error for definition lists with no definitions (#3832).

• DocBook writer:

  • Fix internal links with writerIdentifierPrefix opt(#3397, Mauro Bieg).

• Docx writer:

  • Don't include bookmarks on headers unless non-null id (#3476).
  • Support 9 levels of headers (#1642).
  • Allow 9 list levels (#3519).
  • Don't take distArchive from datadir (#3322). The docx writer takescomponents from the distribution's version of reference.docx when itcan't find them in a user's custom reference.docx. Previously, weallowed a reference.docx in the data directory (e.g. ~/.pandoc)to be used as the distribution's reference.docx. This led to abizarre situation where pandoc would produce a good docx using--template ~/.pandoc/ref.docx, but if ref.docx were moved to~/.pandoc/reference.docx, it would then produce a corrupted docx.
  • Fixed handling of soft hyphen (0173) (#3691).
  • Better handling of keywords (#3719).
  • Cleaner code for handling dir and style attributes for Div.
  • Use Set for dynamic styles to avoid duplicates.
  • Removed redundant element from data/docx/word/numbering.xml.The elements we need are generated when the document iscompiled; this didn't do anything.
  • Activate evenAndOddHeaders from reference docx (#3901,Augustín Martín Barbero).

• ODT/OpenDocument writer:

  • Calculate aspect ratio for percentage-sized images (Mauro Bieg, #3239).
  • Use more widely available bullet characters (#1400). The oldcharacters weren't available in some font sets. These seem to workwell on Windows and Linux versions of LibreOffice.
  • Wider labels for lists (#2421). This avoids overly narrow labels forordered lists with () delimiters. However, arguably it createsoverly wide labels for bullets. Also, lists now start flush withthe margin, rather than indented.
  • Fixed dropped elements in some ordered lists (#2434).

• FB2 writer:

  • Don't render RawBlock as code.
  • Don't fail with an error on interior headers (e.g. in list) (#3750).Instead, omit them with an INFO message.
  • Add support for "lang" metadata (Alexander Krotov, #3625).
  • Format LineBlock as poem (Alexander Krotov). Previously writerproduced one paragraph with <empty-line/> elements, which are notallowed inside <p> according to FB2 schema.
  • Replace concatMap with cMap (Alexander Krotov).
  • Write FB2 lists without nesting blocks inside <p> (AlexanderKrotov, #4004)

• HTML writer:

  • Make sure html4, html5 formats work for raw blocks/inlines.
  • Render raw inline environments when --mathjax used (#3816).We previously did this only with raw blocks, on the assumptionthat math environments would always be raw blocks. This has changedsince we now parse them as inline environments.
  • Ensure we don't get two style attributes for width and height.
  • Report when not rendering raw inline/block.
  • Issue warning if no title specified and template used (#3473).
  • Info message if lang is unspecified (#3486).
  • Removed unused parameter in dimensionsToAttributeList.
  • Avoid two class attributes when adding uri class (#3716).
  • Fix internal links with writerIdentifierPrefix opt (#3397, MauroBieg).
  • Use revealjs's math plugin for mathjax (#3743). This is a thinwrapper around mathjax that makes math look better on revealjs.
  • Slidy: use h1 for all slides, even if they were originallylevel 2 headers (#3566). Otherwise the built-in table of contentsin Slidy breaks.

• LaTeX writer:

  • Don't render LaTeX images with data: URIs (#3636). Note that--extract-media can be used when the input contains data: URIs.
  • Make highlighted code blocks work in footnotes (Timm Albers).
  • Don't use figure inside table cell (#3836).
  • Use proper code for list enumerators (#3891). This should fix problemswith lists that don't use arabic numerals.
  • Always add hypertarget when there's a non-empty identifier (#2719).Previously the hypertargets were only added when there was actuallya link to that identifier.
  • Use % after hypertarget before code block.
  • Add \leavevmode before hypertarget at start of paragraph (#2704,fixes formatting problems in beamer citations).
  • Don't use lstinline in \item[..] (#645). If you do, the contentsof item disappear or are misplaced. Use \texttt instead.
  • Fix problem with escaping in lstinline (#1629). Previously theLaTeX writer created invalid LaTeX when --listings was specified anda code span occurred inside emphasis or another construction.
  • Fix error with line breaks after empty content (#2874). LaTeXrequires something before a line break, so we insert a ~ if noprintable content has yet been emitted.
  • Use BCP47 parser.
  • Fixed detection of otherlangs (#3770). We weren't recursing intoinline contexts.
  • Handle language in inline code with --listings (#3422).
  • Write euro symbol directly in LaTeX (Andrew Dunning, #3801).The textcomp package allows pdfLaTeX to parse € directly, making the\euro command unneeded.
  • Fixed footnotes in table captions (#2378). Note that if the table hasa first page header and a continuation page header, the notes willappear only on the first occurrence of the header.
  • In writeBeamer output, allow hyperlinks to frames (#3220).Previously you could link to a header above or below slide level butnot to slide level. This commit changes that. Hypertargets areinserted inside frame titles; technically the reference is to justafter the title, but in normal use (where slides are viewed fullscreen in a slide show), this does not matter.
  • Remove \strut at beginning of table cells (#3436). This fixes aproblem with alignment of lists in table cells. The \strut at theend seems to be enough to avoid the too-close spacing that motivatedaddition of the strut in #1573.
  • Add partial siunitx Support (Marc Schreiber, #3588).

• ConTeXt writer:

  • Refactored to use BCP47 module.
  • Remove unnecessary $ (Alexander Krotov, #3482).
  • Use header identifiers for chapters (#3968).

• EPUB writer:

  • title_page.xhtml is now put in text/.
  • Don't strip formatting in TOC (#1611).

• Textile reader:

  • Fix bug for certain links in table cells (#3667).
  • Allow 'pre' code in list item (#3916).

• HTML reader:

  • Added warnings for ignored material (#3392).
  • Better sanity checks to avoid parsing unintended things asraw HTML in the Markdown reader (#3257).
  • Revise treatment of li with id attribute (#3596). Previously wealways added an empty div before the list item, but this createdproblems with spacing in tight lists. Now we do this: If the listitem contents begin with a Plain block, we modify the Plainblock by adding a Span around its contents. Otherwise, we add aDiv around the contents of the list item (instead of adding anempty Div to the beginning, as before).
  • Add details tag to list of block tags (#3694).
  • Removed button from block tag list (#3717). It is already in theeitherBlockOrInlineTag list, and should be both places.
  • Use Sets instead of lists for block tag lookup.
  • Rewrote to use Text throughout. Effect on memory usage is modest(< 10%).
  • Use the lang value of <html> to set the lang meta value (bucklereed,#3765).
  • Ensure that paragraphs are closed properly when the parent blockelement closes, even without </p> (#3794).
  • Parse <figure> and <figcaption> (Mauro Bieg, #3813).
  • Parse <main> like <div role=main> (bucklereed, #3791).<main> closes <p> and behaves like a block element generally
  • Support column alignments (#1881). These can be set eitherwith a width attribute or with text-width in a style attribute.
  • Modified state type to be an instance of HasLogMessages, soregisterHeader can issue warnings.
  • </td> or </th> should close any open block tag (#3991).
  • <td> should close an open <th> or <td>.
  • htmlTag improvements (#3989). We previously failed on caseswhere an attribute contained a > character. This patch fixes thebug, which especially affects raw HTML in Markdown.

• Txt2Tags reader:

  • Newline is not indentation (Alexander Krotov).

• MediaWiki reader:

  • Allow extra hyphens after |- in tables (#2649).
  • Allow blank line after table start (#2649).
  • Fixed more table issues (#2649).
  • Ensure that list starts begin at left margin (#2606). Including whenthey're in tables or other list items.
  • Make smart double quotes depend on smart extension (#3585).
  • Don't do curly quotes inside <tt> contexts (#3585). Even if +smart.
  • Modified state type to be an instance of HasLogMessages, soregisterHeader can issue warnings.

• TWiki reader (Alexander Krotov):

  • Remove unnecessary $ (#3597).
  • Simplify linkText (#3605).

• EPUB reader:

  • Minor refactoring, avoiding explicit MediaBag handling.This all works behind the scenes in CommonState plumbing.

• Docx reader:

  • Don't drop smartTag contents (#2242).
  • Handle local namespace declarations (#3365). Previously we didn'trecognize math, for example, when the xmlns declaration occurred onthe element and not the root.
  • More efficient trimSps (#1530). Replacing trimLineBreaks. Thisdoes the work of normalizeSpaces as well, so we avoid the need forthat function here.
  • Avoid 0-level headers (Jesse Rosenthal, #3830). We used to parseparagraphs styled with "HeadingN" as "nth-level header." But if adocument has a custom style named "Heading0", this will produce a0-level header, which shouldn't exist. We only parse this styleif N>0. Otherwise we treat it as a normal style name, andfollow its dependencies, if any.
  • Add tests for avoiding zero-level header (Jesse Rosenthal).

• ODT reader:

  • Replaced collectRights with Rights from Data.Either.
  • Remove dead code (Albert Krewinkel).

• Org reader (Albert Krewinkel, unless noted).

  • Don't allow tables inside list items (John MacFarlane, #3499).
  • Disallow tables on list marker lines (#3499).
  • Convert markup at beginning of footnotes (John MacFarlane, #3576).
  • Allow emphasized text to be followed by [ (#3577).
  • Handle line numbering switch for src blocks.The line-numbering switch that can be given to source blocks (-n withan start number as an optional parameter) is parsed and translated to aclass/key-value combination used by highlighting and other readers andwriters.
  • Stop adding rundoc prefix to src params. Source block parameter namesare no longer prefixed with rundoc. This was intended to simplifyworking with the rundoc project, a babel runner. However, the rundocproject is unmaintained, and adding those markers is not the reader'sjob anyway. The original language that is specified for a sourceelement is now retained as the data-org-language attribute and onlyadded if it differs from the translated language.
  • Allow multi-word arguments to src block params (#3477). The reader nowcorrectly parses src block parameter list even if parameter argumentscontain multiple words.
  • Avoid creating nullMeta by applying setMeta directly(Alexander Krotov).
  • Replace sequence . map with mapM.
  • Fix smart parsing behavior. Parsing of smart quotes and specialcharacters can either be enabled via the smart language extension orthe ' and - export options. Smart parsing is active if either theextension or export option is enabled. Only smart parsing of specialcharacters (like ellipses and en and em dashes) is enabled by default,while smart quotes are disabled. Previously, all smart parsing wasdisabled unless the language extension was enabled.
  • Subject full doc tree to headline transformations (Albert Krewinkel,#3695). Emacs parses org documents into a tree structure, which isthen post-processed during exporting. The reader is changed to do thesame, turning the document into a single tree of headlines startingat level0.
  • Fix cite parsing behaviour (Herwig Stuetz). Until now, org-refcite keys included special characters also at the end. This causedproblems when citations occur right before colons or at the end ofa sentence. With this change, all non alphanumeric characters atthe end of a cite key are ignored. This also adds , to the listof special characters that are legal in cite keys to better mirrorthe behaviour of org-export.
  • Fix module names in haddock comments. Copy-pasting had lead tohaddock module descriptions containing the wrong module names.
  • Recognize babel result blocks with attributes (#3706). Babelresult blocks can have block attributes like captions and names.Result blocks with attributes were not recognized and were parsedas normal blocks without attributes.
  • Include tags in headlines. The Emacs default is to include tags in theheadline when exporting. Instead of just empty spans, which contain thetag name as attribute, tags are rendered as small caps and wrapped inthose spans. Non-breaking spaces serve as separators for multiple tags.
  • Respect export option for tags (#3713). Tags are appended toheadlines by default, but will be omitted when the tags export optionis set to nil.
  • Use tag-name attribute instead of data-tag-name.
  • Use org-language attribute rather than data-org-language.
  • Modified state type to be an instance of HasLogMessages, soregisterHeader can issue warnings.
  • End footnotes after two blank lines. Footnotes can not only beterminated by the start of a new footnote or a header, but also by twoconsecutive blank lines.
  • Update emphasis border chars (#3933). The org reader was updated tomatch current org-mode behavior: the set of characters which areacceptable to occur as the first or last character in an org emphasishave been changed and now allows all non-whitespace chars at theinner border of emphasized text (see org-emphasis-regexp-components).

• RST reader:

  • Fixed small bug in list parsing (#3432). Previously the parser didn'thandle properly this case:

    * - a - b* - c - d

  • Handle multiline cells in simple tables (#1166).

  • Parse list table directive (Keiichiro Shikano, #3432).

  • Make use of anyLineNewline (Alexander Krotov, #3686).

  • Use anyLineNewline in rawListItem (Alexander Krotov, #3702).

  • Reorganize block parsers for ~20% faster parsing.

  • Fixed ..include:: directive (#3880).

  • Handle blank lines correctly in line blocks (Alexander Krotov, #3881).Previously pandoc would sometimes combine two line blocks separatedby blanks, and ignore trailing blank lines within the line block.

  • Fix indirect hyperlink targets (#512).

• Markdown reader:

  • Allow attributes in reference links to start on next line (#3674).
  • Parse YAML metadata in a context that sees footnotes defined inthe body of the document (#1279).
  • When splitting pipe table cells, skip tex math (#3481).You might have a | character inside math. (Or for that mattersomething that the parser might mistake for raw HTML.)
  • Treat span with class smallcaps as SmallCaps.This allows users to specify small caps in Markdown this way:[my text]{.smallcaps} (#1592).
  • Fixed internal header links (#2397).This patch also adds shortcut_reference_links to the listof mmd extensions.
  • Treat certain environments as inlinewhen they occur without space surrounding them (#3309, #2171).E.g. equation, math. This avoids incorrect vertical spacearound equations.
  • Optimized nonindentSpaces. Makes the benchmark go from 40 to 36 ms.
  • Allow latex macro definitions indented 1-3 spaces.Previously they only worked if nonindented.
  • Improved parsing of indented raw HTML blocks (#1841).Previously we inadvertently interpreted indented HTML ascode blocks. This was a regression. We now seek to determine theindentation level of the contents of an HTML block, and (optionally)skip that much indentation. As a side effect, indentation may bestripped off of raw HTML blocks, if markdown_in_html_blocks isused. This is better than having things interpreted as indentedcode blocks.
  • Fixed smart quotes after emphasis (#2228). E.g. in *foo*'s 'foo'.
  • Warn for notes defined but not used (#1718).
  • Use anyLineNewline (Alexander Krotov).
  • Interpret YAML metadata as Inlines when possible (#3755). Ifthe metadata field is all on one line, we try to interpret it asInlines, and only try parsing as Blocks if that fails. If itextends over one line (including possibly the | or > charactersignaling an indented block), then we parse as Blocks. This wasmotivated by some German users finding that date: '22. Juin 2017'got parsed as an ordered list.
  • Fixed spurious parsing as citation as reference def (#3840).We now disallow reference keys starting with @ if thecitations extension is enabled.
  • Parse -@roe as suppress-author citation (pandoc-citeproc#237).Previously only [-@roe] (with brackets) was recognized assuppress-author, and -@roe was treated the same as @roe.
  • Fixed parsing of fenced code after list when there is no interveningblank line (#3733).
  • Allow raw latex commands starting with \start (#3558). Previouslythese weren't allowed because they were interpreted as startingConTeXt environments, even without a corresponding \stop...
  • Added inlines, inlines1.
  • Require nonempty alt text for implicit_figures (#2844).A figure with an empty caption doesn't make sense.
  • Removed texmath macro material; now all this is handledin the LaTeX reader functions.
  • Fixed bug with indented code following raw LaTeX (#3947).

• LaTeX reader:

  • Rewrote LaTeX reader with proper tokenization (#1390,#2118, #3236, #3779, #934, #982). This rewrite is primarilymotivated by the need to get macros working properly. A side benefitis that the reader is significantly faster. We now tokenize theinput text, then parse the token stream. Macros modify the tokenstream, so they should now be effective in any context, includingmath. Thus, we no longer need the clunky macro processingcapacities of texmath.
  • Parse \, to \8198 (six-per-em space) (Henri Werth).
  • Allow \newcommand\foo{blah} without braces.
  • Support \lstinputlisting (#2116).
  • Issue warnings when skipping unknown latex commands (#3392).
  • Include contents of \parbox.
  • Allow \hspace and \vspace to count as raw block or inline.Previously we would refuse to parse anything as raw inline ifit was in the blockCommands list. Now we allow exceptionsif they're listed under ignoreInlines in inlineCommands.This should make it easier e.g. to include an \hspacebetween two side-by-side raw LaTeX tables.
  • Don't drop contents of \hypertarget.
  • Handle spaces before \cite arguments.
  • Allow newpage, clearpage, pagebreak in inline contexts as well asblock contexts (#3494).
  • Treat {{xxx}} the same as {xxx} (#2115).
  • Use pMacroDefinition in macro (for more direct parsing).Note that this means that macro will now parse onemacro at a time, rather than parsing a whole group together.
  • Fixed failures on \ref{}, \label{} with +raw_tex. Now thesecommands are parsed as raw if +raw_tex; otherwise, their argumentis parsed as a bracketed string.
  • Don't crash on empty enumerate environment (#3707).
  • Handle escaped & inside table cell (#3708).
  • Handle block structure inside table cells (#3709). minipage is nolonger required.
  • Handle some width specifiers on table columns (#3709). Currentlywe only handle the form 0.9\linewidth. Anything else would haveto be converted to a percentage, using some kind arbitrary assumptionsabout line widths.
  • Make sure \write18 is parsed as raw LaTeX. The change is in theLaTeX reader's treatment of raw commands, but it also affects theMarkdown reader.
  • Fixed regression with starred environment names (#3803).
  • Handle optional args in raw \titleformat (#3804).
  • Improved heuristic for raw block/inline. An unknown command at thebeginning of the line that could be either block or inline istreated as block if we have a sequence of block commands followed bya newline or a \startXXX command (which might start a raw ConTeXtenvironment).
  • Don't remove macro definitions from the output, even ifExt_latex_macros is set, so that macros will be applied.Since they're only applied to math in Markdown, removing the macroscan have bad effects. Even for math macros, keeping them should beharmless.
  • Removed macro. It is no longer necessary, since therawLaTeXBlock parser will parse macro definitions. This also avoidsthe need for a separate latexMacro parser in the Markdown reader.
  • Use label instead of data-label for label in caption (#3639).
  • Fixed space after \figurename etc.
  • Resolve references to section numbers.
  • Fix \let\a=0 case, with single character token.
  • Allow @ as a letter in control sequences. @ is commonly usedin macros using \makeatletter. Ideally we'd make the tokenizersensitive to \makeatletter and \makeatother, but until then thisseems a good change.
  • Track header numbers and correlate with labels.
  • Allow ] inside group in option brackets (#3857).
  • lstinline with braces can be used (verb cannot be used with braces)(Marc Schreiber, #3535).
  • Fix keyval function: pandoc did not parse options in braces correctly(Marc Schreiber, #3642).
  • When parsing raw LaTeX commands, include trailing space (#1773).Otherwise things like \noindent foo break and turn into\noindentfoo. Affects -f latex+raw_tex and -f markdown (and otherformats that allow raw_tex).
  • Don't treat "..." as Quoted (#3958). This caused quotes to be omitted in\texttt contexts.
  • Add tests for existing \includegraphics behaviour (Ben Firshman).
  • Allow space before = in bracketd options (Ben Firshman).
  • Be more forgiving in parsing command options. This was needed, forexample, to make some minted options work.
  • Strip off quotes in \include filenames.

• Added Text.Pandoc.CSV, simple (unexported) CSV parser.

• Text.Pandoc.PDF:

  • Got --resource-path working with PDF output (#852).
  • Fetch images when generating PDF via context (#3380).To do this, we create the temp directory as a subdirectoryof the working directory. Since context mk IV by default looksfor images in the parent directory, this works.
  • Use report instead of warn, make it sensitive to verbosity settings.
  • Use fillMediaBag and extractMedia to extract media to temp dir.This reduces code duplication.
  • html2pdf: use stdin instead of intermediate HTML file
  • Removed useless TEXINPUTS stuff for context2pdf. mkiv contextdoesn't use TEXINPUTS.

• Text.Pandoc.Pretty:

  • Simplified definition of realLength.
  • Don't error for blocks of size < 1. Instead, resize to 1 (see #1785).

• Text.Pandoc.MIME:

  • Use application/javascript (not application/x-javascript).
  • Added emf to mimeTypes with type application/x-msmetafile (#1713).

• Text.Pandoc.ImageSize:

  • Improve SVG image size code (Marc Schreiber, #3580).
  • Make imageSize recognize basic SVG dimensions (Mauro Bieg, #3462).

• Use Control.Monad.State.Strict throughout. This gives 20-30% speedupand reduction of memory usage in most of the writers.

• Use foldrWithKey instead of deprecated foldWithKey.

• Text.Pandoc.SelfContained:

  • Fixed problem with embedded fonts (#3629).
  • Refactored getData from getDataURI in SelfContained.
  • Don't use data URIs for script or style (#3423). Instead, just usescript or style tags with the content inside. The old method withdata URIs prevents certain optimizations outside pandoc. Exception:data URIs are still used when a script contains </script> or astyle contains </.
  • SelfContained: Handle URL inside material retrieved from a URL(#3629). This can happen e.g. with an @import of a google web font.(What is imported is some CSS which contains an url referenceto the font itself.) Also, allow unescaped pipe (|) in URL.
  • Load resources from data-src (needed for lazy loading inreveal.js slide shows).
  • Handle data-background-image attribute on section (#3979).

• Text.Pandoc.Parsing:

  • Added indentWith (Alexander Krotov, #3687).
  • Added stateCitations to ParserState.
  • Removed stateChapters from ParserState.
  • In ParserState, make stateNotes' a Map, add stateNoteRefs.
  • Added gobbleSpaces and gobbleAtMostSpaces.
  • Adjusted type of insertIncludedFile so it can be used with tokenparser.
  • Replace old texmath macro stuff from Parsing. Use Macro fromText.Pandoc.Readers.LaTeX.Types instead.
  • Export insertIncludedFile.
  • Added HasLogMessages, logMessage, reportLogMessages (#3447).
  • Replace partial with total function (Albert Krewinkel).
  • Introduce HasIncludeFiles type class (Albert Krewinkel). TheinsertIncludeFile function is generalized to work with all parserstates which are instances of that class.
  • Add insertIncludedFilesF which returns F blocks (Albert Krewinkel).The insertIncludeFiles function was generalized and renamedto insertIncludedFiles'; the specialized versions are based on that.
  • many1Till: Check for the end condition before parsing (HerwigStuetz). By not checking for the end condition before the firstparse, the parser was applied too often, consuming too much of theinput. This only affects many1Till p end where p matches on aprefix of end.
  • Provide parseFromString (#3690). This is a version ofparseFromString specialied to ParserState, which resetsstateLastStrPos at the end. This is almost always what we want.This fixes a bug where _hi_ wasn't treated as emphasis in thefollowing, because pandoc got confused about the position of thelast word: - [o] _hi_.
  • Added takeP, takeWhileP for efficient parsing of [Char].
  • Fix blanklines documentation (Alexander Krotov, #3843).
  • Give less misleading line information with parseWithString.Previously positions would be reported past the end of the chunk.We now reset the source position within the chunk and reportpositions "in chunk."
  • Add anyLineNewline (Alexander Krotov).
  • Provide shared F monad functions for Markdown and Org readers(Albert Krewinkel). The F monads used for delayed evaluationof certain values in the Markdown and Org readers are based on ashared data type capturing the common pattern of both F types.
  • Add returnF (Alexander Krotov).
  • Avoid parsing Notes:** as a bare URI (#3570). This avoids parsingbare URIs that start with a scheme + colon + *, _, or ].
  • Added readerAbbreviations to ParserState. Markdown readernow consults this to determine what is an abbreviation.
  • Combine grid table parsers (Albert Krewinkel, #3638). The grid tableparsers for markdown and rst was combined into one singleparser gridTable, slightly changing parsing behavior of bothparsers: (1) The markdown parser now compactifies block contentcell-wise: pure text blocks in cells are now treated as paragraphsonly if the cell contains multiple paragraphs, and as plain blocksotherwise. Before, this was true only for single-column tables. (2)The rst parser now accepts newlines and multiple blocks in headercells.
  • Generalize tableWith, gridTableWith (Albert Krewinkel).The parsing functions tableWith and gridTableWith are generalizedto work with more parsers. The parser state only has to be aninstance of the HasOptions class instead of requiring a concretetype. Block parsers are required to return blocks wrapped into amonad, as this makes it possible to use parsers returning resultswrapped in Futures.

• Text.Pandoc.Shared:

  • Simplify toRomanNumeral using guards (Alexander Krotov, #3445)
  • stringify: handle Quoted better (#3958). Previously we were losingthe quotation marks in Quoted elements.

• Text.Pandoc.Writers.Shared:

  • Export metaToJSON', addVariablesToJSON (#3439).This allows us to add the variables AFTER using the metadatato generate a YAML header (in the Markdown writer).
  • Added unsmartify (previously in RST writer).Undo literal double curly quotes. Previously we left these.
  • Generalize type of metaToJSON so it can take a Text. Previously aString was needed as argument; now any ToJSON instance will do.
  • Added gridTable (previously in Markdown writer).
  • gridTable: Refactored to use widths in chars.
  • gridTable: remove unnecessary extra space in cells.
  • Fixed addVariablesToJSON. It was previously not allowing multiplevalues to become lists.
  • Pipe tables: impose minimum cell size (see #3526).

Default template changes

• HTML templates (including EPUB and HTML slide show templates):

  • Make default.html5 polyglot markup conformant (John Luke Bentley,#3473). Polyglot markup is HTML5 that is also valid XHTML. Seehttps://www.w3.org/TR/html-polyglot. With this change, pandoc'shtml5 writer creates HTML that is both valid HTML5 and valid XHTML.
  • Regularized CSS in html/epub/html slide templates (#3485).All templates now include code{white-space: pre-wrap}and CSS for q if --html-q-tags is used. Previously some templateshad pre and others pre-wrap; the q styles were only sometimesincluded.
  • CSS for .smallcaps, (Mauro Bieg, #1592)
  • default.revealjs: make history default to true.
  • default.revealjs: use lazy loading (#2283).
  • default.revealjs: add mathjax variable and some conditional codeto use the MathJaX plugin.
  • default.slidy uses https instead of http (ickc, #3848).
  • default.dzslides: Load Google Font using HTTPS by default(Yoan Blanc).

• DocBook5 template: Use lang and subtitle variables (Jens Getreu,#3855).

• LaTeX/Beamer template:

  • Combine LaTeX/Beamer templates (Andrew Dunning, #3878).default.beamer has been removed; beamer now uses thedefault.latex template. Beamer-specific parts are conditionalon the beamer variable set by the writer. Note thatpandoc -D beamer will return this (combined) template.
  • Use xcolor for colorlinks option (Andrew Dunning, #3877).Beamer loads xcolor rather than color, and thus thedvipsnames option doesn't take effect. This also provides a widerrange of colour selections with the svgnames option.
  • Use starred versions of xcolor names (Andrew Dunning).Prevents changes to documents defined using the dvipsnames list (e.g.Blue gives a different result with svgnames enabled).
  • Load polyglossia after header-includes (#3898). It needs to beloaded as late as possible.
  • Use unicode-math (Vaclav Haisman). Use mathspec with onlyXeLaTeX on request.
  • Don't load fontspec before unicode-math (over there).The unicode-math package loads fontspec so explict loading offontspec before unicode-math is not necessary.
  • Use unicode-math by default in default.latex template. mathspec willbe used in xelatex if the mathspec variable is set; otherwiseunicode-math will be used (Václav Haisman).
  • Use dvipsnames options when colorlinks specified (otherwisewe get an error for maroon) (Thomas Hodgson).
  • Added beamer titlegraphic and logo variables (Thomas Hodgson).
  • Fix typo in fix for notes in tables (#2378, zeeMonkeez).
  • Fix hyperref options clash (Andrew Dunning, #3847) Avoids an optionsclash when loading a package (e.g. tufte-latex) that useshyperref settings different from those in the template.
  • Add natbiboptions variable (#3768).
  • Fix links inside captions in LaTeX output with links-as-notes(Václav Haisman, #3651). Declare our redefined \href robust.
  • Load parskip before hyperref (Václav Haisman, #3654).
  • Allow setting Japanese fonts when using LuaLaTeX (Václav Haisman,#3873). by using the luatexja-fontspec and luatexja-presetpackages. Use existing CJKmainfont and CJKoptions templatevariables. Add luatexjafontspecoptions for luatexja-fontspecand luatexjapresetoptions for luatexja-preset.
  • Added aspectratio variable to beamer template (Václav Haisman,#3723).
  • Modified template.latex to fix XeLaTex being used with tables(lwolfsonkin, #3661). Reordered lang variable handling toimmediately before bidi.

• ConTeXt template: Improved font handling: simplefonts is nowobsolete in ConTeXt (Pablo Rodríguez).

Documentation improvements

• MANUAL.txt:

  • Add URL for Prince HTML > PDF engine (Ian, #3919).
  • Document that content above slide-level will be omitted inslide shows. See #3460, #2265.
  • Explain --webtex SVG url (Mauro Bieg, #3471)
  • Small clarification in YAML metadata section.
  • Document that html4 is technically XHTML 1.0 transitional.
  • Remove refs to highlighting-kate (#3672).
  • Document ibooks specific epub metadata.
  • Clarify that mathml is used for ODT math.
  • Mention limitations of Literate Haskell Support (#3410,Joachim Breitner).
  • Add documentation of limitations of grid tables (StephenMcDowell, #3864).
  • Clarify that meta-json contains transformed values (Jakob Voß,#3491) Make clear that template variable meta-json does notcontain plain text values or JSON output format but field valuestransformed to the selected output format.

• COPYRIGHT:

  • Clarify that templates are dual-licensed.
  • Clarify that pandoc-types is BSD3 licensed.
  • List new files not written by jgm (Albert Krewinkel).
  • Update dates in copyright notices (Albert Krewinkel). This followsthe suggestions given by the FSF for GPL licensed software.https://www.gnu.org/prep/maintain/html_node/Copyright-Notices.html

• INSTALL.md:

  • Improved instructions for tests with patterns.
  • Put RPM-based distros on separate point (Mauro Bieg, #3449)

• CONTRIBUTING.md:

  • Fixed typos (Wandmalfarbe, #3479).
  • Add "ask on pandoc-discuss" (Mauro Bieg).

• Add lua filter documentation in doc/lua-filters.md. Note that theend of this document is autogenerated from data/pandoc.luausing make doc/lua-filters.md, which uses tools/ldoc.ltp(Albert Krewinkel).

• Add doc/filters.md. This is the old scripting tutorial fromthe website.

• Add doc/using-the-pandoc-api.md (#3289). This gives an introductionto using pandoc as a Haskell library.

Build infrastructure improvements

• Removed data/templates submodule. Templates are now a subtreein data/templates. This removes the need to do git submodule update.

• Renamed tests -> test.

• Remove https flag. Always build with HTTPS support.

• Use file-embed instead of hsb2hs to embed data files whenembed_data_files flag is set. file-embed gives us better dependencytracking: if a data file changes, ghc/stack/cabal know to recompilethe Data module. This also removes hsb2hs as a build dependency.

• Add custom-setup stanza to pandoc, lowercase field names.

• Add static Cabal flag.

• Name change OSX -> MacOS. Add a -MacOS suffix to mac package ratherthan -OSX. Changed local names from osx to macos.

• make_macos_package.sh - Use strip to reduce executable size.

• Revised binary linux package. Now a completely static executableis created, using Docker and alpine. We create both a deb and atarball. The old deb directory has been replaced with a linuxdirectory. Running make in the linux directory shouldperform the build, putting the binary packages in artifacts/.

• linux/control.in: add Replaces:, so existing pandoc-citeproc andpandoc-data packages will be uninstalled; this package providesboth (#3822). Add latex packages as 'suggested', updatedescription.

• Remove cpphs build requirement -- it is no longer needed.

• Replaced {deb,macos,windows}/stack.yaml with stack.pkg.yaml.

• Name change OSX -> macOS (ickc, #3869).

• Fix casing of Linux, UNIX, and Windows (ickc).

• .travis.yml: create a source dist and do cabal build and test there.That way we catch errors due to files missing from the datasection of pandoc.cabal.

• Makefile:

  • Split make haddock from make full.
  • Add BRANCH variable for winpkg.
  • Add lint target.
  • Improve make full. Disable optimizations.Build everything, inc. trypandoc and benchmarks. Use parallel build.
  • Allow make test to take TESTARGS.

• Added new command tests (Tests.Command), using small text filesin test/command/. Any files added in this directory will be treatedas shell tests (see smart.md for an example). This makes it very easyto add regression tests etc.

• Test fixes so we can find data files. In old tests & command tests,we now set the environment variable pandoc_datadir. In lua tests,we set the datadir explicitly.

• Refactored compareOutput in docx writer test.

• Consolidated some common functions in Tests.Helper.

• Small change to unbalanced bracket test to speed up test suite.

• Speed up Native writer quickcheck tests.

• Use tasty for tests rather than test-framework.

• Add simple Emacs mode to help with Pandoc templates editing.(Václav Haisman, #3889). tools/pandoc-template-mode.el

pandoc 1.19.2.4 (2017-09-10)

• Add dependencies on texmath and skylighting to the executable.This is needed for dependency version numbers to be available,with Cabal > 2.

pandoc 1.19.2.3 (2017-09-09)

• Add CPP to Setup.hs so it works with Cabal >= 2 and < 2.

pandoc 1.19.2.2 (2017-09-08)

• Fix build with GHC 8.2.1 (#3876, Peter Simons). Setup.hs does notcompile with Cabal 2.x, so we require an earlier version viasetup-depends. The following packages need newer versions withGHC 8.2.1 and had their constraints relaxed accordingly:executable-path, process, syb, and time.

pandoc 1.19.2.1 (2017-01-31)

• Require skylighting >= 0.1.1.4.
• Adjust test output for skylighting version.
• Relax upper bounds on blaze-html and blaze-markup.

pandoc 1.19.2 (2017-01-29)

• Use skylighting library instead of highlighting-kate for syntaxhighlighting. Skylighting is faster and more accurate (#3363).Later we'll be able to add features like warning messages, dynamicloading of xml syntax definitions, and dynamic loading of themes.

• Added a new highlight style, breezeDark.

• Text.Pandoc.Highlighting: Update list of listings languages (#3374).This allows more languages to be used when using the --listingsoption.

• OpenDocument writer:

  • Small refactoring. Removed separate 'parent' parameter in paraStyle.
  • Don't profilerate text styles unnecessarily (#3371).This change makes the writer create only as many temporarytext styles as are absolutely necessary. It also consolidatesadjacent nodes with the same style.

• Org reader (Albert Krewinkel):

  • Allow short hand for single-line raw blocks (Albert Krewinkel,#3366). Single-line raw blocks can be given via #+FORMAT: raw line,where FORMAT must be one of latex, beamer, html, or texinfo.
  • Accept org-ref citations followed by commas (Albert Krewinkel).Bugfix for an issue which, whenever the citation was immediatelyfollowed by a comma, prevented correct parsing of org-ref citations.
  • Ensure emphasis markup can be nested. Nested emphasis markup (e.g./*strong and emphasized*/) was interpreted incorrectly in that theinner markup was not recognized.
  • Remove pipe char irking the haddock coverage tool (Albert Krewinkel).

• Docx reader: Empty header should be list of lists (Jesse Rosenthal).In the past, the docx reader wrote an empty header as an empty list. Itshould have the same width as a row (and be filled with empty cells).

• MediaWiki reader:

  • Improved handling of display math (#3362). Sometimes display math isindented with more than one colon. Previously we handled these casesbadly, generating definition lists and missing the math.
  • Fix quotation mark parsing (#3336, tgkokk). Change MediaWiki reader'sbehavior when the smart option is parsed to match other readers'behavior.

• Markdown reader:

  • Fixed -f markdown_github-hard_line_breaks+escaped_line_breaks(#3341). Previously this did not properly enable escaped line breaks.
  • Disallow space between inline code and attributes (#3326, #3323,Mauro Bieg).

• DocBook5 writer: make id attribute xml:id, fixes #3329 (#3330, Mauro Bieg).

• Added some test cases for ODT reader (#3306, #3308, Hubert Plociniczak).

• LaTeX writer: allow tables with empty cells to count as "plain."This addresses a problem of too-wide tables when empty cellsare used. Thanks to Joost Kremers for reporting the issue.

• Org writer: prefix footnote numbers with fn: (Albert Krewinkel).Unprefixed numbers where used by older org-mode versions, but are nolonger supported.

• HTML writer: don't process pars with empty RawInline, (#1040, #3327,Mauro Bieg).

• Markdown writer: Fix display math with --webtex (#3298).

• Fix sample.lua so it properly handles raw blocks/inlines (#3358,bumper314).

• Templates:

  • default.latex: Moved geometry after hyperref (Václav Haisman).Otherwise PDF sizes can be wrong in some circ*mstances.
  • Copied a few changes from default.latex to default.beamer(Wandmalfarbe).
  • default.latex, default.beamer: Changed position of \VerbatimNotesand fancyvrb. This fixes hyperlinks on footnotes in documentsthat contain verbatim in notes (#3361). (Note: the beamer templatewas updated to match the LaTeX template, but at this point verbatimin notes seems not to work in beamer.)
  • default.latex: Allow passing microtypeoptions to microtype(Václav Haisman).
  • default.latex: Add hyphen option to url package.
  • default.docbook5: Fix namespace declarations (Mauro Bieg).

• Moved make_osx_package.sh to osx/ directory.

• Travis continuous integration:

  • Fix false positives with dist build.
  • Speed improvements (Kolen Cheung, #3304, #3357).

• MANUAL.txt:

  • Clarify that blank space is needed around footnotes (#3352).
  • Fixed typo (#3351, Alexey Rogechev).
  • Note that --wrap=auto does not work in HTML output.
  • Default --columns width is 72, not 80.
  • Fixed broken links (#3316, Kolen Cheung).
  • Document usage of @* in nocite section (#3333, John Muccigrosso).

• INSTALL.md:

  • Indent code so it's properly formatted (#3335, Bheesham Persaud).
  • Added instructions for extracting binary from OSX, Windows packages.

• CONTRIBUTING.md: Describe labels currently used in issue tracker(Albert Krewinkel). The labels have changed over time, the list oflabels is updated to reflect the current set of labels used in theissue tracker.

• Rearrange and extend badges in README (Albert Krewinkel, #3354)

• Bumped version bounds for dependencies.

pandoc 1.19.1 (2016-12-10)

• Set PANDOC_VERSION environment variable for filters (#2640).This allows filters to check the pandoc version that producedthe JSON they are receiving.

• Docx reader: Ensure one-row tables don't have header (#3285,Jesse Rosenthal). Tables in MS Word are set by default to havespecial first-row formatting, which pandoc uses to determine whetheror not they have a header. This means that one-row tables will, bydefault, have only a header -- which we imagine is not what peoplewant. This change ensures that a one-row table is not understood tobe a header only. Note that this means that it is impossible toproduce a header-only table from docx, even though it is legalpandoc. But we believe that in nearly all cases, it will be anaccidental (and unwelcome) result

• HTML reader:

  • Fixed some bad regressions in HTML table parser (#3280).This regression leads to the introduction of empty rowsin some circ*mstances.
  • Understand style=width: as well as width in col (#3286).

• RST reader:

  • Print warnings when keys, substitition, notes not found.Previously the parsers failed and we got raw text. Now we get alink with an empty URL, or empty inlines in the case of a note orsubstitution.

  • Fix hyperlink aliases (#3283).

• Man writer: Ensure that periods are escaped at beginning of line(#3270).

• LaTeX writer: Fix unnumbered headers when used with --top-level(#3272, Albert Krewinkel). Fix interaction of top-leveldivisions part or chapter with unnumbered headers whenemitting LaTeX. Headers are ensured to be written usingstared commands (like \subsection*{}).

• LaTeX template: use comma not semicolon to separate keywords forpdfkeywords. Thanks to Wandmalfarbe.

• Markdown writer: Fixed incorrect word wrapping (#3277).Previously pandoc would sometimes wrap lines too early due tothis bug.

• Text.Pandoc.Pretty: Added afterBreak [API change]. This makes itpossible to insert escape codes for content that needs escaping at thebeginning of a line.

• Removed old MathMLInHTML.js from 2004, which should no longerbe needed for MathML with modern browsers.

• Fixed tests with dynamic linking (#2709).

• Makefile: Use stack instead of cabal for targets. This is justa convenience for developers.

• Fixed bash completion of filenames with space (#2749).

• MANUAL: improved documentation on how to create a customreference.docx.

• Fix minor spelling typos in the manual (#3273, Anthony Geoghegan)

pandoc 1.19 (2016-12-01)

• Changed resolution of filter paths.

  • We now first treat the argument of --filter as a full (absoluteor relative) path, looking for a program there. If it's found, werun it.
  • If not, and if it is a simple program name or a relative path, wetry resolving it relative to $DATADIR/filters.
  • If this fails, then we treat it as a program name and look in theuser's PATH.
  • Removed a hardcoded '/' that may have caused problems withWindows paths.

  Previously if you did --filter foo and you had foo in your path andalso an executable foo in your working directory, the one in the pathwould be used. Now the one in the working directory is used.

  In addition, when you do --filter foo/bar.hs, pandoc will now find afilter $DATADIR/filters/foo/bar.hs -- assuming there isn't afoo/bar.hs relative to the working directory.

• Allow file:// URIs as arguments (#3196). Also improved default readerformat detection. Previously with a URI ending in .md or .markdown,pandoc would assume HTML input. Now it treats these as markdown.

• Allow to overwrite top-level division type heuristics (#3258,Albert Krewinkel). Pandoc uses heuristics to determine the mostreasonable top-level division type when emitting LaTeX orDocbook markup. It is now possible to overwrite this implicitly settop-level division via the top-level-division command line parameter.

• Text.Pandoc.Options [API changes]:

  • Removed writerStandalone field in WriterOptions, madewriterTemplate a Maybe value. Previously settingwriterStandalone = True did nothing unless a template was providedin writerTemplate. Now a fragment will be generated ifwriterTemplate is Nothing; otherwise, the specified templatewill be used and standalone output generated.
  • Division has been renamed TopLevelDivision (#3197). TheSection, Chapter, and Part constructors were renamed toTopLevelSection, TopLevelChapter, andTopLevelPart, respectively. An additional TopLevelDefaultconstructor was added, which is now also the new default value ofthe writerTopLevelDivision field in WriterOptions.

• Improved error if they give wrong arg to --top-level-division.

• Use new module from texmath to lookup MS font codepoints in Docx reader.Removed unexported module Text.Pandoc.Readers.Docx.Fonts. Its code nowlives in texmath (0.9).

• DocBook reader: Fixed xref lookup (#3243). It previously only workedwhen the qnames lacked the docbook namespace URI.

• HTML reader:

  • Improved table parsing (#3027). We now check explicitly for non-1rowspan or colspan attributes, and fail when we encounter them.Previously we checked that each row had the same number of cells,but that could be true even with rowspans/colspans. And there arecases where it isn't true in tables that we can handle fine -- e.g.when a tr element is empty. So now we just pad rows with empty cellswhen needed.
  • Treat <math> as MathML by default unless something else isexplicitly specified in xmlns. Provided it parses as MathML,of course. Also fixed default which should be to inline math if nodisplay attribute is used.
  • Only treat "a" element as link if it has href (#3226). Otherwisetreat as span.

• Docx reader (Jesse Rosenthal):

  • Add a placeholder value for CHART. We wrap [CHART] in a<span class="chart">. Note that it maps to inlines because, indocx, anything in a drawing tag can be part of a larger paragraph.
  • Be more specific in parsing images We not only want w:drawing,because that could also include charts. Now we specifyw:drawing/pic:pic. This shouldn't change behavior at all, but it'sa first step toward allowing other sorts of drawing data as well.
  • Abstract out function to avoid code repetition.
  • Update tests for img title and alt (#3204).
  • Handle Alt text and titles in images. We use the "description" fieldas alt text and the "title" field as title. These can be accessedthrough the "Format Picture" dialog in Word.
  • Docx reader utils: handle empty namespace in elemName. Previously,if given an empty namespace (elemName ns "" "foo") elemNamewould output a QName with a Just "" namespace. This is never whatwe want. Now we output a Nothing. If someone does want aJust "" in the namespace, they can enter the QNamevalue explicitly.

• ODT reader/writer:

  • Inline code when text has a special style (Hubert Plociniczak). Whena piece of text has a text Source_Text then we assume that this isa piece of the document that represents a code that needs tobe inlined. Adapted the writer to also reflect that change.Previously it was just writing a 'preformatted' text using anon-distinguishable font style. Code blocks are still not recognizedby the ODT reader. That's a separate issue.

  • Infer table's caption from the paragraph (#3224,Hubert Plociniczak). ODT's reader always put empty captions for theparsed tables. This commit

    1. checks paragraphs that follow the table definition
    2. treats specially a paragraph with a style named 'Table'
    3. does some postprocessing of the paragraphs that combines tablesfollowed immediately by captions

    The ODT writer used the TableCaption style for the captionparagraph. This commit follows the OpenOffice approach which allowsfor appending captions to table but uses a built-in style namedTable instead of TableCaption. Users of a custom reference.odtshould change the style's name from TableCaption to Table.

• ODT reader: Infer tables' header props from rows (#3199,Hubert Plociniczak). ODT reader simply provided an empty header listwhich meant that the contents of the whole table, even if not empty, wassimply ignored. While we still do not infer headers we at least have toprovide default properties of columns.

• Markdown reader:

  • Allow reference link labels starting with @... if citationsextension disabled (#3209). Example: in

    \[link text\]\[@a\]

    link text isn't hyperlinked because [@a] is parsed asa citation. Previously this happened whether or not the citationsextension was enabled. Now it happens only if the citationsextension is enabled.

  • Allow alignments to be specified in Markdown grid tables. Forexample,

    +-------+---------------+--------------------+| Right | Left | Centered |+=========:+:=================+:=============:+| Bananas | $1.34 | built-in wrapper |+-------+---------------+--------------------+

  • Allow Small Caps elements to be created using bracketed spans (asthey already can be using HTML-syntax spans) (#3191, Kolen Cheung).

• LaTeX reader:

  • Don't treat \vspace and \hspace as block commands (#3256).Fixed an error which came up, for example, with \vspace insidea caption. (Captions expect inlines.)
  • Improved table handling. We can now parse all of the tables emittedby pandoc in our tests. The only thing we don't get yet arealignments and column widths in more complex tables. See #2669.
  • Limited support for minipage.
  • Allow for []s inside LaTeX optional args. Fixes cases like:
  • Handle BVerbatim from fancyvrb (#3203).
  • Handle hungarumlaut (#3201).
  • Allow beamer-style <...> options in raw LaTeX (also in Markdown)(#3184). This allows use of things like \only<2,3>{my content} inMarkdown that is going to be converted to beamer.

• Use pre-wrap for code in dzslides template (Nicolas Porcel). Otherwiseoverly long code will appear on every slide.

• Org reader (Albert Krewinkel):

  • Respect column width settings (#3246). Table column properties canoptionally specify a column's width with which it is displayed inthe buffer. Some exporters, notably the ODT exporter in org-modev9.0, use these values to calculate relative column widths. The orgreader now implements the same behavior. Note that the org-modeLaTeX and HTML exporters in Emacs don't support this feature yet,which should be kept in mind by users who use the columnwidths parameters.

  • Allow HTML attribs on non-figure images (#3222). Images which arethe only element in a paragraph can still be given HTML attributes,even if the image does not have a caption and is hence not a figure.The following will add set the width attribute of the image to50%:

    +ATTR\_HTML: :width 50%=======================\[\[file:image.jpg\]\]

  • Support ATTR_HTML for special blocks (#3182). Specialblocks (i.e. blocks with unrecognized names) can be prefixed with anATTR_HTML block attribute. The attributes defined in thatmeta-directive are added to the Div which is used to represent thespecial block.

  • Support the todo export option. The todo export option allows totoggle the inclusion of TODO keywords in the output. Setting this tonil causes TODO keywords to be dropped from headlines. The defaultis to include the keywords.

  • Add support for todo-markers. Headlines can have optionaltodo-markers which can be controlled via the #+TODO, #+SEQ_TODO,or #+TYP_TODO meta directive. Multiple such directives can begiven, each adding a new set of recognized todo-markers. If nocustom todo-markers are defined, the default TODO and DONEmarkers are used. Todo-markers are conceptually separate fromheadline text and are hence excluded when autogeneratingheadline IDs. The markers are rendered as spans and labelled withtwo classes: One class is the markers name, the other signals thetodo-state of the marker (either todo or done).

• LaTeX writer:

  • Use \autocites* when "suppress-author" citation used.
  • Ensure that simple tables have simple cells (#2666). If cellscontain more than a single Plain or Para, then we need to setnonzero widths and put contents into minipages.
  • Remove invalid inlines in sections (#3218, Hubert Plociniczak).

• Markdown writer:

  • Fix calculation of column widths for aligned multiline tables(#1911, Björn Peemöller). This also fixes excessive CPU and memoryusage for tables when --columns is set in such a way that cellsmust be very tiny. Now cells are guaranteed to be big enough so thatsingle words don't need to line break, even if this pushes the linelength above the column width.
  • Use bracketed form for native spans when bracketed_spansenabled (#3229).
  • Fixed inconsistent spacing issue (#3232). Previously a tight bulletsublist got rendered with a blank line after, while a tight orderedsublist did not. Now we don't get the blank line in either case.
  • Fix escaping of spaces in super/subscript (#3225). Previously twobackslashes were inserted, which gave a literal backslash.
  • Adjust widths in Markdown grid tables so that they matchon round-trip.

• Docx writer:

  • Give full detail when there are errors converting tex math.
  • Handle title text in images (Jesse Rosenthal). We already handledalt text. This just puts the image "title" into the docx"title" attr.
  • Fixed XML markup for empty cells (#3238). Previously the Compactstyle wasn't being applied properly to empty cells.

• HTML writer:

  • Updated renderHtml import from blaze-html.

• Text.Pandoc.Pretty:

  • Fixed some bugs that caused blank lines in tables (#3251). The bugscaused spurious blank lines in grid tables when we had things likeblankline $$ blankline.
  • Add exported function minOffet [API change] (Björn Peemöller).
  • Added error message for illegal call to block (Björn Peemöller).

• Text.Pandoc.Shared:

  • Put warn in MonadIO.
  • fetchItem: Better handling of protocol-relative URL (#2635). IfURL starts with // and there is no "base URL" (as there would beif a URL were used on the command line), then default to http:.

• Export Text.Pandoc.getDefaultExtensions [API change] (#3178).

• In --version, trap error in getAppUserDataDirectory (#3241). Thisfixes a crash with pandoc --version on unusual systems with no realuser (e.g. SQL Server 2016).

• Added weigh-pandoc for memory usage diagnostics (#3169).

• Use correct mime types for woff and woff2 (#3228).

• Remove make_travis_yml.hs (#3235, Kolen Cheung).

• changelog: Moved an item that was misplaced in the 1.17.2 section to the1.18 section where it belongs.

• CONTRIBUTING.md: minor change in wording and punctuation (#3252,Kolen Cheung).

• Further revisions to manual for --version changes (#3244).

pandoc 1.18 (2016-10-26)

• Added --list-input-formats, --list-output-formats,--list-extensions, --list-highlight-languages, and--list-highlight-styles (#3173). Removed list of highlightinglanguages from --version output. Removed list of input and outputformats from default --help output.

• Added --reference-location=block|section|document option(Jesse Rosenthal). This determines whether Markdown link referencesand footnotes are placed at the end of the document, the end of thesection, or the end of the top-level block.

• Added --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.The --chapters option has been deprecated in favor of--top-level-division=chapter.

• Added LineBlock constructor for Block (Albert Krewinkel). Thisis now used in parsing RST and Markdown line blocks, DocBooklinegroup/line combinations, and Org-mode VERSE blocks.Previously Para blocks with hard linebreaks were used. LineBlocksare handled specially in the following ouput formats: AsciiDoc(as [verse] blocks), ConTeXt (\startlines/\endlines),HTML (div with a style), Markdown (line blocks if line_blocksis enabled), Org-mode (VERSE blocks), RST (line blocks). Inother output formats, a paragraph with hard linebreaks is emitted.

• Allow binary formats to be written to stdout (but not to tty) (#2677).Only works on posix, since we use the unix library to check whetheroutput is to tty. On Windows, pandoc works as before and always requiresan output file parameter for binary formats.

• Changed JSON output format (Jesse Rosenthal). Previously we usedgenerically generated JSON, but this was subject to change dependingon the version of aeson pandoc was compiled with. To ensure stability,we switched to using manually written ToJSON and FromJSONinstances, and encoding the API version. Note: pandoc filterlibraries will need to be revised to handle the format change.Here is a summary of the essential changes:

  • The toplevel JSON format is now {"pandoc-api-version" : [MAJ, MIN, REV], "meta" : META, "blocks": BLOCKS}instead of [{"unMeta": META}, [BLOCKS]].Decoding fails if the major and minor version numbers don'tmatch.
  • 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.

• Removed tests/Tests/Arbitrary.hs and added a Text.Pandoc.Arbitrarymodule to pandoc-types (Jesse Rosenthal). This makes it easierto use QuickCheck with pandoc types outside of pandoc itself.

• Add bracketed_spans Markdown extension, enabled by defaultin pandoc markdown. This allows you to create a native spanusing this syntax: [Here is my span]{#id .class key="val"}.

• Added angle_brackets_escapable Markdown extension (#2846).This is needed because github flavored Markdown has a slightlydifferent set of escapable symbols than original Markdown;it includes angle brackets.

• Export Text.Pandoc.Error in Text.Pandoc [API change].

• Print highlighting-kate version in --version.

• Text.Pandoc.Options:

  • Extension has new constructors Ext_brackted_spans andExt_angle_brackets_escapable [API change].
  • Added ReferenceLocation type [API change] (Jesse Rosenthal).
  • Added writerReferenceLocation field to WriterOptions (JesseRosenthal).

• --filter: we now check $DATADIR/filters for filters beforelooking in the path (#3127, Jesse Rosenthal, thanks to JakobVoß for the idea). Filters placed in this directory need notbe executable; if the extension is .hs, .php, .pl, .js,or .rb, pandoc will run the right interpreter.

• For --webtex, replace deprecated Google Chart API by CodeCogs asdefault (Kolen Cheung).

• Removed raw_tex extension from markdown_mmd defaults (Kolen Cheung).

• Execute .js filters with node (Jakob Voß).

• Textile reader:

  • Support bc.. extended code blocks (#3037). Also, remove trailingnewline in code blocks (consistently with Markdown reader).
  • Improve table parsing. We now handle cell and row attributes, mostlyby skipping them. However, alignments are now handled properly.Since in pandoc alignment is per-column, not per-cell, wetry to devine column alignments from cell alignments.Table captions are also now parsed, and textile indicatorsfor thead and tfoot no longer cause parse failure. (However,a row designated as tfoot will just be a regular row in pandoc.)
  • Improve definition list parsing. We now allow multiple terms(which we concatenate with linebreaks). An exponential parsingbug (#3020) is also fixed.
  • Disallow empty URL in explicit link (#3036).

• RST reader:

  • Use Div instead of BlockQuote for admonitions (#3031).The Div has class admonition and (if relevant) one of thefollowing: attention, caution, danger, error, hint,important, note, tip, warning. Note: This will changethe rendering of some RST documents! The word ("Warning", "Attention",etc.) is no longer added; that must be done with CSS or a filter.
  • A Div is now used for sidebar as well.
  • Skip whitespace before note (Jesse Rosenthal, #3163). RST requires aspace before a footnote marker. We discard those spaces so that footnoteswill be adjacent to the text that comes before it. This is in line withwhat rst2latex does.
  • Allow empty lines when parsing line blocks (Albert Krewinkel).

• Markdown reader:

  • Allow empty lines when parsing line blocks (Albert Krewinkel).
  • Allow attributes on autolinks (#3183, Daniele D'Orazio).

• LaTeX reader:

  • More robust parsing of unknown environments (#3026).We no longer fail on things like ^ inside options for tikz.
  • Be more forgiving of non-standard characters, e.g. ^ outside of math.Some custom environments give these a meaning, so we should try not tofall over when we encounter them.
  • Drop duplicate * in bibtexKeyChars (Albert Krewinkel)

• MediaWiki reader:

  • Fix for unquoted attribute values in mediawiki tables (#3053).Previously an unquoted attribute value in a table rowcould cause parsing problems.
  • Improved treatment of verbatim constructions (#3055).Previously these yielded strings of alternating Code and Spaceelements; we now incorporate the spaces into the Code. Emphasisetc. is still possible inside these.
  • Properly interpret XML tags in pre environments (#3042). They are meantto be interpreted as literal text.

• EPUB reader: don't add root path to data: URIs (#3150).Thanks to @lep for the bug report and patch.

• Org reader (Albert Krewinkel):

  • Preserve indentation of verse lines (#3064). Leading spaces in verselines are converted to non-breaking spaces, so indentation is preserved.
  • Ensure image sources are proper links. Image sources as those in plainimages, image links, or figures, must be proper URIs or relative filepaths to be recognized as images. This restriction is now enforcedfor all image sources. This also fixes the reader's usage of uncleanedimage sources, leading to file: prefixes not being deleted fromfigure images. Thanks to @bsag for noticing this bug.
  • Trim verse lines properly (Albert Krewinkel).
  • Extract meta parsing code to module. Parsing of meta-data is wellseparable from other block parsing tasks. Moving into new module toget small files and clearly arranged code.
  • Read markup only for special meta keys. Most meta-keys should be readas normal string values, only a few are interpreted as marked-up text.
  • Allow multiple, comma-separated authors. Multiple authors can bespecified in the #+AUTHOR meta line if they are given as acomma-separated list.
  • Give precedence to later meta lines. The last meta-line of any giventype is the significant line. Previously the value of the first linewas kept, even if more lines of the same type were encounterd.
  • Read LaTeX_header as header-includes. LaTeX-specific header commandscan be defined in #+LaTeX_header lines. They are parsed asformat-specific inlines to ensure that they will only show up in LaTeXoutput.
  • Set documentclass meta from LaTeX_class.
  • Set classoption meta from LaTeX_class_options.
  • Read HTML_head as header-includes. HTML-specific head content can bedefined in #+HTML_head lines. They are parsed as format-specificinlines to ensure that they will only show up in HTML output.
  • Respect author export option. The author option controls whetherthe author should be included in the final markup. Setting#+OPTIONS: author:nil will drop the author from the final meta-dataoutput.
  • Respect email export option. The email option controls whether theemail meta-field should be included in the final markup. Setting#+OPTIONS: email:nil will drop the email field from the finalmeta-data output.
  • Respect creator export option. The creator option controls whetherthe creator meta-field should be included in the final markup. Setting#+OPTIONS: creator:nil will drop the creator field from the finalmeta-data output. Org-mode recognizes the special value comment forthis field, causing the creator to be included in a comment. This isdifficult to translate to Pandoc internals and is hence interpreted thesame as other truish values (i.e. the meta field is kept if it'spresent).
  • Respect unnumbered header property (#3095). Sections the unnumberedproperty should, as the name implies, be excluded from the automaticnumbering of section provided by some output formats. The Pandocconvention for this is to add an "unnumbered" class to the header. Thereader treats properties as key-value pairs per default, so a specialcase is added to translate the above property to a class instead.
  • Allow figure with empty caption (Albert Krewinkel, #3161).A #+CAPTION attribute before an image is enough to turn an image intoa figure. This wasn't the case because the parseFromString function,which processes the caption value, would fail on empty values. Addinga newline character to the caption value fixes this.

• Docx reader:

  • Use XML convenience functions (Jesse Rosenthal).The functions isElem and elemName (defined in Docx/Util.hs) makethe code a lot cleaner than the original XML.Light functions, but theyhad been used inconsistently. This puts them in wherever applicable.
  • Handle anchor spans with content in headers. Previously, we would onlybe able to figure out internal links to a header in a docx if theanchor span was empty. We change that to read the inlines out of thefirst anchor span in a header.
  • Let headers use exisiting id. Previously we always generated an id forheaders (since they wouldn't bring one from Docx). Now we let it use anexisting one if possible. This should allow us to recurs through anchorspans.
  • Use all anchor spans for header ids. Previously we only used the firstanchor span to affect header ids. This allows us to use all the anchorspans in a header, whether they're nested or not (#3088).
  • Test for nested anchor spans in header. This ensures that anchor spansin header with content (or with other anchor spans inside) will resolveto links to a header id properly.

• ODT reader (Hubert Plociniczak)

  • Include list's starting value. Previously the starting value ofthe lists' items has been hardcoded to 1. In reality ODT's liststyle definition can provide a new starting value in one of itsattributes.
  • Infer caption from the text following the image.Frame can contain other frames with the text boxes.
  • Add fig: to title for Image with a caption (as expectedby pandoc's writers).
  • Basic support for images in ODT documents.
  • Don't duplicate text for anchors (#3143). When creating an anchorelement we were adding its representation as well as the originalcontent, leading to text duplication.

• DocBook writer:

  • Include an anchor element when a div or span has an id (#3102).Note that DocBook does not have a class attribute, but at least thisprovides an anchor for internal links.

• LaTeX writer:

  • Don't use * for unnumbered paragraph, subparagraph. The starredvariants don't exist. This helps with part of #3058...it gets rid ofthe spurious *s. But we still have numbers on the 4th and 5th levelheaders.
  • Properly escape backticks in verbatim (#3121, Jesse Rosenthal).Otherwise they can cause unintended ligatures like ?`.
  • Handle NARRAOW NO-BREAK SPACE into LaTeX (Vaclav Zeman) as \,.
  • Don't include [htbp] placement for figures (#3103, Václav Haisman).This allows figure placement defaults to be changed by the userin the template.

• TEI writer: remove heuristic to detect book template (Albert Krewinkel).TEI doesn't have <book> elements but only generic <divN> divisionelements. Checking the template for a trailing </book> is nonsensical.

• MediaWiki writer: transform filename with underscores in images (#3052).foo bar.jpg becomes foo_bar.jpg. This was already donefor internal links, but it also needs to happen for images.

• ICML writer: replace partial function (!!) in table handling (#3175,Mauro Bieg).

• Man writer: allow section numbers that are not a single digit (#3089).

• AsciiDoc writer: avoid unnecessary use of "unconstrained" emphasis(#3068). In AsciiDoc, you must use a special form of emphasis(double __) for intraword emphasis. Pandoc was previously usingthis more than necessary.

• EPUB writer: use stringify instead of plain writer for metadata(#3066). This means that underscores won't be used for emphasis,or CAPS for bold. The metadata fields will just have unadornedtext.

• Docx Writer:

  • Implement user-defined styles (Jesse Rosenthal). Divs and Spanswith a custom-style key in the attributes will apply the correspondingkey to the contained blocks or inlines.
  • Add ReaderT env to the docx writer (Jesse Rosenthal).
  • Clean up and streamline RTL behavior (Jesse Rosenthal, #3140).You can set dir: rtl in YAML metadata, or use -M dir=rtlon the command line. For finer-grained control, you can setthe dir attribute in Div or Span elements.

• Org writer (Albert Krewinkel):

  • Remove blank line after figure caption. Org-mode only treats an imageas a figure if it is directly preceded by a caption.
  • Ensure blank line after figure. An Org-mode figure should be surroundedby blank lines. The figure would be recognized regardless, but imagesin the following line would unintentionally be treated as figures aswell.
  • Ensure link targets are paths or URLs. Org-mode treats links asdocument internal searches unless the link target looks like a URL orfile path, either relative or absolute. This change ensures that thisis always the case.
  • Translate language identifiers. Pandoc and Org-mode use differentprogramming language identifiers. An additional translation betweenthose identifiers is added to avoid unexpected behavior. This fixes aproblem where language specific source code would sometimes be outputas example code.
  • Drop space before footnote markers (Albert Krewinkel, #3162).The writer no longer adds an extra space before footnote markers.

• Markdown writer:

  • Don't emit HTML for tables unless raw_html extension is set (#3154).Emit [TABLE] if no suitable table formats are enabled and raw HTMLis disabled.
  • Check for the raw_html extension before emitting a raw HTML block.
  • Abstract out note/ref function (Jesse Rosenthal).
  • Add ReaderT monad for environment variables (Jesse Rosenthal).

• HTML, EPUB, slidy, revealjs templates: Use <p> instead of <h1> forsubtitle, author, date (#3119). Note that, as a result of this change,authors may need to update CSS.

• revealjs template: Added notes-server option(jgm/pandoc-templates#212, Yoan Blanc).

• Beamer template:

  • Restore whitespace between paragraphs. This wasa regression in the last release (jgm/pandoc-templates#207).
  • Added themeoptions variable (Carsten Gips).
  • Added beamerarticle variable. This causes the beamerarticlepackage to be loaded in beamer, to produce an article from beamerslides. (Carsten Gips)
  • Added support for fontfamilies structured variable(Artem Klevtsov).
  • Added hypersetup options (Jake Zimmerman).

• LaTeX template:

  • Added dummy definition for \institute.This isn't a standard command, and we want to avoid a crash wheninstitute is used with the default template.
  • Define default figure placement (Václav Haisman), since pandocno longer includes [htbp] for figures. Users with custom templateswill want to add this. See #3103.
  • Use footnote package to fix notes in tables (jgm/pandoc-templates#208,Václav Haisman).

• Moved template compiling/rendering code to a separate library.doctemplates. This allows the pandoc templating system to beused independently.

• Text.Pandoc.Error: Fix out of index error in handleError(Matthew Pickering). The fix is to not try to show the exact line whenit would cause an out-of-bounds error as a result of included files.

• Text.Pandoc.Shared: Add linesToBlock function (Albert Krewinkel).

• Text.Pandoc.Parsing.emailAddress: tighten up parsing of emailaddresses. Technically **@user is a valid email address, but if weallow things like this, we get bad results in markdown flavorsthat autolink raw email addresses (see #2940). So we exclude a fewvalid email addresses in order to avoid these more common bad cases.

• Text.Pandoc.PDF: Don't crash with nonexistent image (#3100). Instead,emit the alt text, emphasized. This accords with what the ODT writercurrently does. The user will still get a warning about a nonexistentimage.

• Fix example in API documentation (#3176, Thomas Weißschuh).

• Tell where to get tarball in INSTALL (#3062).

• Rename README to MANUAL.txt and add GitHub-friendly README.md(Albert Krewinkel, Kolen Cheung).

• Replace COPYING with Markdown version COPYING.md from GNU (Kolen Cheung).

• MANUAL.txt:

  • Put note on structured vars in separate paragraph (#2148, AlbertKrewinkel). Make it clearer that structured author variables require acustom template
  • Note that --katex works best with html5 (#3077).
  • Fix the LaTeX and EPUB links in manual (Morton Fox).
  • Document biblio-title variable.

• Improve spacing of footnotes in --help output (Waldir Pimenta).

• Update KaTeX to v0.6.0 (Kolen Cheung).

• Allow latest dependencies.

• Use texmath 0.8.6.6 (#3040).

• Allow http-client 0.4.30, which is the version in stackage lts.Previously we required 0.5.Remove CPP conditionals for earlier versions.

• Remove support for GHC < 7.8 (Jesse Rosenthal).

  • Remove Compat.Monoid.
  • Remove an inline monad compatibility macro.
  • Remove Text.Pandoc.Compat.Except.
  • Remove directory compat.
  • Change constraint on mtl.
  • Remove unnecessary CPP condition in UTF8.
  • Bump base lower bound to 4.7.
  • Remove 7.6 build from .travis.yaml.
  • Bump supported ghc version in CONTRIBUTING.md.
  • Add note about GHC version support to INSTALL.
  • Remove GHC 7.6 from list of tested versions (Albert Krewinkel).
  • Remove TagSoup compat.
  • Add EOL note to time compat module. Because time 1.4 is a boot libraryfor GHC 7.8, we will support the compatibility module as long as wesupport 7.8. But we should be clear about when we will no longer needit.
  • Remove blaze-html CPP conditional.
  • Remove unnecessary CPP in custom Prelude.

pandoc 1.17.2 (2016-07-17)

• Added Zim Wiki writer, template and tests. zimwiki is nowa valid output format. (Alex Ivkin)

• Changed email-obfuscation default to no obfuscation (#2988).

  • writerEmailObfuscation in defaultWriterOptions is nowNoObfuscation.
  • the default for the command-line --email-obfuscation option isnow none.

• Docbook writer: Declare xlink namespace in Docbook5 output (Ivo Clarysse).

• Org writer:

  • Support arbitrary raw inlines (Albert Krewinkel).Org mode allows arbitrary raw inlines ("export snippets" in Emacsparlance) to be included as @@format:raw foreign format text@@.
  • Improve Div handling (Albert Krewinkel). Div blocks handling ischanged to make the output look more like idiomatic org mode:
    • Div-wrapped content is output as-is if the div's attribute is thenull attribute.
    • Div containers with an id but neither classes nor key-value pairsare unwrapped and the id is added as an anchor.
    • Divs with classes associated with greater block elements arewrapped in a #+BEGIN...#+END block.
    • The old behavior for Divs with more complex attributes is kept.

• HTML writer: Better support for raw LaTeX environments (#2758).Previously we just passed all raw TeX through when MathJaxwas used for HTML math. This passed through too much.With this patch, only raw LaTeX environments that MathJaxcan handle get passed through.This patch also causes raw LaTeX environments to be treatedas math, when possible, with MathML and WebTeX output.

• Markdown writer: use raw HTML for simple, pipe tables with linebreaks(#2993). Markdown line breaks involve a newline, and simple and pipetables can't contain one.

• Make --webtex work with the Markdown writer (#1177).This is a convenient option for people usingwebsites whose Markdown flavors don't provide for math.

• Docx writer:

  • Set paragraph to FirstPara after display math (Jesse Rosenthal).We treat display math like block quotes, and apply FirstParagraph styleto paragraphs that follow them. These can be styled as the userwishes. (But, when the user is using indentation, this allows forparagraphs to continue after display math without indentation.)
  • Use actual creation time as doc prop (Jesse Rosenthal).Previously, we had used the user-supplied date, if available, for Word'sdocument creation metadata. This could lead to weird results, as incases where the user post-dates a document (so the modification might beprior to the creation). Here we use the actual computer time to set thedocument creation.

• LaTeX writer:

  • Don't URI-escape image source (#2825). Usually this is a local file,and replacing spaces with %20 ruins things.
  • Allow 'standout' as a beamer frame option (#3007).## Slide title {.standout}.

• RST reader: Fixed links with no explicit link text. The link`<foo>`_ should have foo as both its link text and its URL.See RST spec at http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#embedded-uris-and-aliasesCloses Debian #828167 -- reported by Christian Heller.

• Textile reader:

  • Fixed attributes (#2984). Attributes can't be followed bya space. So, _(class)emph_ but _(noclass) emph_.
  • Fixed exponential parsing bug (#3020).
  • Fix overly aggressive interpretation as images (#2998).Spaces are not allowed in the image URL in textile.

• LaTeX reader:

  • Fix \cite so it is a NormalCitation not AuthorInText.
  • Strip off double quotes around image source if present (#2825).Avoids interpreting these as part of the literal filename.

• Org reader:

  • Add semicolon to list of special chars (Albert Krewinkel)Semicolons are used as special characters in citations syntax. Thisensures the correct parsing of Pandoc-style citations: [prefix; @key; suffix]. Previously, parsing would have failed unless there was a spaceor other special character as the last character.
  • Add support for "Berkeley-style" cites (Albert Krewinkel, #1978).A specification for an official Org-mode citation syntax was drafted byRichard Lawrence and enhanced with the help of others on the orgmodemailing list. Basic support for this citation style is added to thereader.
  • Support arbitrary raw inlines (Albert Krewinkel).Org mode allows arbitrary raw inlines ("export snippets" in Emacsparlance) to be included as @@format:raw foreign format text@@.
  • Remove partial functions (Albert Krewinkel, #2991).Partial functions like head lead to avoidable errors and should beavoided. They are replaced with total functions.
  • Support figure labels (Albert Krewinkel, #2496, #2999).Figure labels given as #+LABEL: thelabel are used as the ID of therespective image. This allows e.g. the LaTeX to add proper \labelmarkup.
  • Improve tag and properties type safety (Albert Krewinkel).Specific newtype definitions are used to replace stringly typing of tagsand properties. Type safety is increased while readability is improved.
  • Parse as headlines, convert to blocks (Albert Krewinkel).Emacs org-mode is based on outline-mode, which treats documents as treeswith headlines are nodes. The reader is refactored to parse into asimilar tree structure. This simplifies transformations acting ondocument (sub-)trees.
  • Refactor comment tree handling (Albert Krewinkel).Comment trees were handled after parsing, as pattern matching on listsis easier than matching on sequences. The new method of readingdocuments as trees allows for more elegant subtree removal.
  • Support archived trees export options (Albert Krewinkel).Handling of archived trees can be modified using the arch option.Archived trees are either dropped, exported completely, or collapsed toinclude just the header when the arch option is nil, non-nil, orheadline, respectively.
  • Put export setting parser into module (Albert Krewinkel).Export option parsing is distinct enough from general block parsing tojustify putting it into a separate module.
  • Support headline levels export setting (Albert Krewinkel).The depths of headlines can be modified using the H option. Deeperheadlines will be converted to lists.
  • Replace ugly code with view pattern (Albert Krewinkel).Some less-than-smart code required a pragma switching of overlappingpattern warnings in order to compile seamlessly. Using view patternsmakes the code easier to read and also doesn't require overlappingpattern checks to be disabled.
  • Fix parsing of verbatim inlines (Albert Krewinkel, #3016).Org rules for allowed characters before or after markup chars were notchecked for verbatim text. This resultet in wrong parsing outcomes ofif the verbatim text contained e.g. space enclosed markup characters aspart of the text (=is_substr = True=). Forcing the parser to updatethe positions of allowed/forbidden markup border characters fixes this.

• LaTeX template: fix for obscure hyperref/xelatex issue.Here's a minimal case:

  \documentclass[]{article}\usepackage{hyperref}\begin{document}\section{\%á}\end{document}

  Without this change, this fails on the second invocation of xelatex.This affects inputs this like # %á with pdf output via xelatex.

• trypandoc: call results 'html' instead of 'result'.This is for better compatibility with babelmark2.

• Document MultiMarkdown as input/output format (Albert Krewinkel, #2973).MultiMarkdown was only mentioned as a supported Markdown dialect but notas a possible input or output format. A brief mention is addedeverywhere the other supported markdown dialects are mentioned.

• Document Org mode as a format containing raw HTML (Albert Krewinkel)Raw HTML is kept when the output format is Emacs Org mode.

• Implement RawInline and RawBlock in sample lua custom writer (#2985).

• Text.Pandoc.Shared:

  • Introduce blocksToInlines function (Jesse Rosenthal).This is a lossy function for converting [Block] -> [Inline]. Its mainuse, at the moment, is for docx comments, which can contain arbitraryblocks (except for footnotes), but which will be converted to spans.This is, at the moment, pretty useless for everything but the basicPara and Plain comments. It can be improved, but the docx readershould probably emit a warning if the comment contains more than this.
  • Add BlockQuote to blocksToInlines (Jesse Rosenthal).
  • Add further formats for normalizeDate (Jesse Rosenthal).We want to avoid illegal dates -- in particular years with greater thanfour digits. We attempt to parse series of digits first as %Y%m%d, then%Y%m, and finally %Y.
  • normalizeDate should reject illegal years (Jesse Rosenthal).We only allow years between 1601 and 9999, inclusive. The ISO 8601actually says that years are supposed to start with 1583, but MS Wordonly allows 1601-9999. This should stop corrupted word files if the dateis out of that range, or is parsed incorrectly.
  • Improve year sanity check in normalizeDate (Jesse Rosenthal).Previously we parsed a list of dates, took the first one, and thentested its year range. That meant that if the first one failed, wereturned nothing, regardless of what the others did. Now we test forsanity before running msum over the list of Maybe values. Anythingfailing the test will be Nothing, so will not be a candidate.

• Docx reader:

  • Add simple comment functionality. (Jesse Rosenthal).This adds simple track-changes comment parsing to the docx reader. It isturned on with --track-changes=all. All comments are converted toinlines, which can list some information. In the future a warning will beadded for comments with formatting that seems like it will be excessivelydenatured. Note that comments can extend across blocks. For that reasonthere are two spans: comment-start and comment-end. comment-startwill contain the comment. comment-end will always be empty. The twowill be associated by a numeric id.
  • Enable warnings in top-level reader (Jesse Rosenthal).Previously we had only allowed for warnings in the parser. Now we allowfor them in the Docx.hs as well. The warnings are simply concatenated.
  • Add warning for advanced comment formatting. (Jesse Rosenthal).We can't guarantee we'll convert every comment correctly, though we'lldo the best we can. This warns if the comment includes something otherthan Para or Plain.
  • Add tests for warnings. (Jesse Rosenthal).
  • Add tests for comments (Jesse Rosenthal).We test for comments, using all track-changes options. Note that weshould only output comments if --track-changes=all. We also test foremitting warnings if there is complicated formatting.

• README: update to include track-changes comments. (Jesse Rosenthal)

• Improved Windows installer - don't ignore properties set on command-line.See #2708. Needs testing to see if this resolves the issue.Thanks to @nkalvi.

• Process markdown extensions on command line in L->R order (#2995).Previously they were processed, very unintuitively, in R->Lorder, so that markdown-tex_math_dollars+tex_math_dollarshad tex_math_dollars disabled.

• Added secnumdepth variable to LaTeX template (#2920).

• Include table of contents in README.html in Windows package.

• Writers: treat SoftBreak as space for stripping (Jesse Rosenthal)In Writers.Shared, we strip leading and trailing spaces for displaymath. Since SoftBreak's are treated as spaces, we should strip thosetoo.

• beamer, latex templates: pass biblatexoptions directly in package load.This allows runtime optinos to be used. Fixes jgm/pandoc-citeproc#201

• CPP workaround for deprecation of parseUrl in http-client.

• Removed some redundant class constraints.

• make_oxs_package.sh - use OSX env variable.

• Added winpkg target to Makefile. This downloads the windows packagefrom appveyor and signs it using the key.

• Document Org mode as a format containing raw TeX (Albert Krewinkel).Raw TeX is kept verbatim when the output format is Emacs Org mode.

• Support math with haddock-library >= 1.4.

• Removed -rtsopts from library stanza. It has no effect, and Hackagewouldn't accept the package.

• Update library dependency versions.

pandoc 1.17.1 (2016-06-04)

• New output format: docbook5 (Ivo Clarysse).

• Text.Pandoc.Options: Add writerDocBook5 to WriterOptions(API change).

• Org writer:

  • Add :PROPERTIES: drawer support (Albert Krewinkel, #1962).This allows header attributes to be added to org documents in the formof :PROPERTIES: drawers. All available attributes are stored askey/value pairs. This reflects the way the org reader handles:PROPERTIES: blocks.
  • Add drawer capability (Carlos Sosa). For the implementation of theDrawer element in the Org Writer, we make use of a generic Blockcontainer with attributes. The presence of a drawer class definesthat the Div constructor is a drawer. The first class defines thedrawer name to use. The key-value list in the attributes definesthe keys to add inside the Drawer. Lastly, the list of Block elementscontains miscellaneous blocks elements to add inside of the Drawer.
  • Use CUSTOM_ID in properties (Albert Krewinkel). The ID property isreserved for internal use by Org-mode and should not be used.The CUSTOM_ID property is to be used instead, it is converted to theID property for certain export format.

• LaTeX writer:

  • Ignore --incremental unless output format is beamer (#2843).
  • Fix polyglossia to babel env mapping (Mauro Bieg, #2728).Allow for optional argument in square brackets.
  • Recognize la-x-classic as Classical Latin (Andrew Dunning).This allows one to access the hyphenation patterns in CTAN'shyph-utf8.
  • Add missing languages from hyph-utf8 (Andrew Dunning).
  • Improve use of \strut with \minipage inside tables(Jose Luis Duran). This improves spacing in multilinetables.
  • Use {} around options containing special chars (#2892).
  • Avoid lazy foldl.
  • Don't escape underscore in labels (#2921). Previously they wereescaped as ux5f.
  • brazilian -> brazil for polyglossia (#2953).

• HTML writer: Ensure mathjax link is added when math appears in footnote(#2881). Previously if a document only had math in a footnote, theMathJax link would not be added.

• EPUB writer: set navpage variable on nav page.This allows templates to treat it differently.

• DocBook writer:

  • Use docbook5 if writerDocbook5 is set (Ivo Clarysse).
  • Properly handle ulink/link (Ivo Clarysse).

• EPUB reader:

  • Unescape URIs in spine (#2924).
  • EPUB reader: normalise link id (Mauro Bieg).

• Docx Reader:

  • Parse moveTo and moveFrom (Jesse Rosenthal).moveTo and moveFrom are track-changes tags that are used when ablock of text is moved in the document. We now recognize these tags andtreat them the same as insert and delete, respectively. So,--track-changes=accept will show the moved version, while--track-changes=reject will show the original version.
  • Tests for track-changes moving (Jesse Rosenthal).

• ODT, EPUB, Docx readers: throw PandocError on unzip failure(Jesse Rosenthal) Previously, readDocx, readEPUB, and readOdtwould error out if zip-archive failed. We change the archive extractionstep from toArchive to toArchiveOrFail, which returns an Either value.

• Markdown, HTML readers: be more forgiving about unescaped & inHTML (#2410). We are now more forgiving about parsing invalid HTML withunescaped & as raw HTML. (Previously any unescaped &would cause pandoc not to recognize the string as raw HTML.)

• Markdown reader:

  • Fix pandoc title blocks with lines ending in 2 spaces (#2799).
  • Added -s to markdown-reader-more test.

• HTML reader: fixed bug in pClose. This caused exponential parsingbehavior in documnets with unclosed tags in dl, dd, dt.

• MediaWiki reader: Allow spaces before ! in MediaWiki table header(roblabla).

• RST reader: Support :class: option for code block in RST reader(Sidharth Kapur).

• Org reader (all Albert Krewinkel, except where noted otherwise):

  • Stop padding short table rows.Emacs Org-mode doesn't add any padding to table rows. The firstrow (header or first body row) is used to determine the column count,no other magic is performed.
  • Refactor rows-to-table conversion. This refactorsthe codes conversing a list table lines to an org table ADT.The old code was simplified and is now slightly less ugly.
  • Fix handling of empty table cells, rows (Albert Krewinkel, #2616).This fixes Org mode parsing of some corner cases regarding empty cellsand rows. Empty cells weren't parsed correctly, e.g. ||| should betwo empty cells, but would be parsed as a single cell containing a pipecharacter. Empty rows where parsed as alignment rows and dropped fromthe output.
  • Fix spacing after LaTeX-style symbols.The org-reader was droping space after unescaped LaTeX-style symbolcommands: \ForAll \Auml resulted in ∀Ä but should give ∀ Äinstead. This seems to be because the LaTeX-reader treats thecommand-terminating space as part of the command. Dropping the trailingspace from the symbol-command fixes this issue.
  • Print empty table rows. Empty table rows should notbe dropped from the output, so row-height is always set to be at least 1.
  • Move parser state into separate module.The org reader code has become large and confusing. Extracting smallerparts into submodules should help to clean things up.
  • Add support for sub/superscript export options.Org-mode allows to specify export settings via #+OPTIONS lines.Disabling simple sub- and superscripts is one of these export options,this options is now supported.
  • Support special strings export option Parsing of special strings(like ... as ellipsis or -- as en dash) can be toggled using the -option.
  • Support emphasized text export option. Parsing of emphasized text canbe toggled using the * option. This influences parsing of text markedas emphasized, strong, strikeout, and underline. Parsing of inline math,code, and verbatim text is not affected by this option.
  • Support smart quotes export option. Reading of smart quotes can betoggled using the ' option.
  • Parse but ignore export options. All known export options are parsedbut ignored.
  • Refactor block attribute handling. A parser state attribute was usedto keep track of block attributes defined in meta-lines. Global stateis undesirable, so block attributes are no longer saved as part of theparser state. Old functions and the respective part of the parser stateare removed.
  • Use custom anyLine. Additional state changes need to be made aftera newline is parsed, otherwise markup may not be recognized correctly.This fixes a bug where markup after certain block-types would not berecognized.
  • Add support for ATTR_HTML attributes (#1906).Arbitrary key-value pairs can be added to some block types using a#+ATTR_HTML line before the block. Emacs Org-mode only includes thesewhen exporting to HTML, but since we cannot make this distinction here,the attributes are always added. The functionality is now supportedfor figures.
  • Add :PROPERTIES: drawer support (#1877).Headers can have optional :PROPERTIES: drawers associated with them.These drawers contain key/value pairs like the header's id. Thereader adds all listed pairs to the header's attributes; id andclass attributes are handled specially to match the way Attr aredefined. This also changes behavior of how drawers of unknown typeare handled. Instead of including all unknown drawers, those are notread/exported, thereby matching current Emacs behavior.
  • Use CUSTOM_ID in properties. See above on Org writer changes.
  • Respect drawer export setting. The d export option can be usedto control which drawers are exported and which are discarded.Basic support for this option is added here.
  • Ignore leading space in org code blocks (Emanuel Evans, #2862).Also fix up tab handling for leading whitespace in code blocks.
  • Support new syntax for export blocks. Org-mode version 9uses a new syntax for export blocks. Instead of #+BEGIN_<FORMAT>,where <FORMAT> is the format of the block's content, the newformat uses #+BEGIN_export <FORMAT> instead. Both types aresupported.
  • Refactor BEGIN...END block parsing.
  • Fix handling of whitespace in blocks, allowing content to be indentedless then the block header.
  • Support org-ref style citations. The org-ref package is anorg-mode extension commonly used to manage citations in orgdocuments. Basic support for the cite:citeKey and[[cite:citeKey][prefix text::suffix text]] syntax is added.
  • Split code into separate modules, making for cleaner code andbetter decoupling.

• Added docbook5 template.

• --mathjax improvements:

  • Use new CommonHTML output for MathJax (updated default MathJax URL,#2858).
  • Change default mathjax setup to use TeX-AMS_CHTML configuration.This is designed for cases where the input is always TeX and maximalconformity with TeX is desired. It seems to be smaller and load fasterthan what we used before. See #2858.
  • Load the full MathJax config to maximize loading speed (KolenCheung).

• Bumped upper version bounds to allow use of latest packagesand compilation with ghc 8.

• Require texmath 0.8.6.2. Closes several texmath-related bugs (#2775,#2310, #2310, #2824). This fixes behavior of roots, e.g.\sqrt[3]{x}, and issues with sub/superscript positioningand matrix column alignment in docx.

• README:

  • Clarified documentation of implicit_header_references (#2904).
  • Improved documentation of --columns option.

• Added appveyor setup, with artefacts (Jan Schulz).

• stack.yaml versions: Use proper flags used for texmath, pandoc-citeproc.

• LaTeX template: support for custom font families (vladipus).Needed for correct polyglossia operation with Cyrillic fonts and perhapscan find some other usages. Example usage in YAML metadata:

   fontfamilies: - name: \cyrillicfont font: Liberation Serif - name: \cyrillicfonttt options: Scale=MatchLowercase font: Liberation

• Create unsigned msi as build artifact in appveyor build.

• On travis, test with ghc 8.0.1; drop testing for ghc 7.4.1.

pandoc 1.17.0.3 (2016-03-24)

• LaTeX writer: Fixed position of label in figures (#2813).Previously the label wasn't in the right place, and \refwouldn't work properly.
• Added .tei test files to pandoc.cabal so they'll be includedin tarball (#2811).
• Updated copyright dates.

pandoc 1.17.0.2 (2016-03-23)

• Fixed serious regression in htmlInBalanced, which causednewlines to be omitted in some raw HTML blocks in Markdown(#2804).

pandoc 1.17.0.1 (2016-03-21)

• File scope is no longer used when there are no input files (i.e.,when input comes from stdin). Previously file scope was triggeredwhen the json reader was specified and input came from stdin,and this caused no output to be produced. (Fix due to Jesse Rosenthal;thanks to Fedor Sheremetyev for calling the bug to our attention.)
• Improved documentation of templates (#2797).

pandoc 1.17 (2016-03-20)

• Added --file-scope option (Jesse Rosenthal).By default pandoc operates on multiple files by first concatenatingthem (around extra line breaks) and then processing the joined file. Soit only parses a multi-file document at the document scope. This has thebenefit that footnotes and links can be in different files, but forsome purposes it is useful to parse the individual files firstand then combine their outputs (e.g. when the files use footnotesor links with the same labels). The --file-scope option causespandoc to parse the files first, and then combine the parsed output,instead of combining before parsing. --file-scope is selectedautomatically for binary input files (which cannot be concatenated)and for pandoc json.

• Add TEI Writer (Chris Forster) and tei output format.

• Added a general ByteStringReader with warnings, used by the docxreader (API change, Jesse Rosenthal).

• Add readDocxWithWarnings (API change, Jesse Rosenthal).

• Changed type of Shared.uniqueIdent argument from[String] to Set String. This avoids performance problems in documentswith many identically named headers (API change, #2671).

• Removed tex_math_single_backslash from markdown_github options(#2707).

• Make language extensions as well as full language namestrigger syntax highlighting. For example, py will now work aswell as python (jgm/highlighting-kate#83).

• Added institute variable to latex, beamer templates (FraserTweedale, Josef Svenningsson).

• Docx reader (Jesse Rosenthal):

  • Handle alternate content. Some word functions (especially graphics)give various choices for content so there can be backwards compatibility.
  • Don't turn numbered headers into lists.
  • Docx Reader: Add state to the parser, for warnings
  • Update feature checklist in source code.
  • Get rid of Modifiable typeclass.
  • Add tests for adjacent hyperlinks.
  • Add a "Link" modifier to Reducible. We want to make sure thatlinks have their spaces removed, and are appropriately smushedtogether (#2689).

• HTML reader:

  • Fixed behavior of base tag (#2777).If the base path does not end with slash, the last componentwill be replaced. E.g. base = http://example.com/foocombines with bar.html to give http://example.com/bar.html.If the href begins with a slash, the whole path of the baseis replaced. E.g. base = http://example.com/foo/ combineswith /bar.html to give http://example.com/bar.html.
  • Rewrote htmlInBalanced. This version avoids an exponentialperformance problem with <script> tags, and it should be fasterin general (#2730).
  • Properly handle an empty cell in a simple table (#2718).
  • Handle multiple <meta> tags with same name. Put them in a listin the metadata so they are all preserved, rather than (as before)throwing out all but one..

• Markdown reader:

  • Improved pipe table parsing (#2765).
  • Allow + separators in pipe table cells. We already allowedthem in the header, but not in the body rows, for some reason.This gives compatibility with org-mode tables.
  • Don't cross line boundary parsing pipe table row.Previously an Emph element could be parsed across the newlineat the end of the pipe table row.
  • Use htmlInBalanced for rawVerbatimBlock, for betterperformance (#2730).
  • Fixed bug with smart quotes around tex math.

• LaTeX reader:

  • Handle interior $ characters in math (#2743). For example,$$\hbox{$i$}$$.
  • inlineCommand now gobbles an empty {} after any command (#2687).This gives better results when people write e.g. \TeX{} in Markdown.
  • Properly handle LaTeX "math" environment as inline math (#2171).

• Textile reader: Support >, <, =, <> text alignment attributes.Closes #2674.

• Org reader (Albert Krewinkel):

  • Prefix even empty figure names with "fig:" (#2643). Theconvention used by pandoc for figures is to mark them by prefixingthe name with fig:. The org reader failed to do this if a figurehad no name.
  • Refactor link-target processing (#2684).

• ConTeXt writer: Fix whitespace at line beginning in line blocks (#2744).Thanks to @c-foster.

• HTML writer: Don't include alignment attribute for default table columns.Previously these were given "left" alignment. Better to leave offalignment attributes altogether (#2694).

• Markdown writer: Use hyphens for YAML metadata block bottom line, forbetter compatibility with other Markdown flavors (Henrik Tramberend).

• LaTeX writer:

  • Use image identifier to create a label and hypertarget forfigures (Mauro Bieg).
  • Avoid double toprule in headerless table with caption (#2742).
  • Clean up options parser (Jesse Rosenthal).
  • Treat memoir template with article option as article, insteadof treating all memoir templates as books.
  • Allow more flexible table alignment (Henrik Tramberend, #2665).New default is not to include [c] option (which is the defaultanyway if no positioning is specified). Now LaTeX emplates cancontrol the overall table alignment in a document by setting thelongtable length variables LTleft and LTright. For example,\setlength\LTleft\parindent\setlength\LTright\fillwill create left-aligned tables that respect paragraph indentation.

• Docx writer: Handle image alt text (#2754, Mauro Bieg).

• Org writer - pass through RawInline with format "org".

• DokuWiki writer: use $$ for display math.

• Custom writer: Pass attributes parameter to CaptionedImage (#2697).

• Make protocol-relative URIs work again (#2737).

• make_osx_package.sh: Use env variable for developer id certs.

• Raise tagsoup lower bound to 0.13.7 to fix entity-relatedproblems (#2734).

• Allow zip-archive 0.3.

• Allow aeson 0.11.

pandoc 1.16.0.2 (2016-01-12)

• Depend on deepseq rather than deepseq-generics (fpco/stackage#1096).

• Fixed regression in latex smart quote parsing (#2645).In cases where a match was not found for a quote, everythingfrom the open quote to the end of the paragraph was being dropped.

pandoc 1.16.0.1 (2016-01-10)

• Fixed regression with --latex-engine (#2618). In 1.16--latex-engine raises an error if a full path is given.

• Org reader: Fix function dropping subtrees tagged :noexport(Albert Krewinkel, #2628):

• Markdown reader: renormalize table column widths if they exceed 100%(#2626).

• Textile reader: don't allow block HTML tags in inline contexts.The reader previously did allow this, following redcloth,which happily parses

  Html blocks can be <div>inlined</div> as well.

  as

  <p>Html blocks can be <div>inlined</div> as well.</p>

  This is invalid HTML. The above sample now produces;

  <p>Html blocks can be</p><div><p>inlined</p></div><p>as well.</p>

• Improved default template lookup for custom lua scripts (#2625).Previously, if you tried to do pandoc -s -t /path/to/lua/script.lua,pandoc would look for the template in~/.pandoc/templates/default./path/to/lua/script.lua.With this change it will look in the more reasonable~/.pandoc/templates/default.script.lua. This makes it possible tostore default templates for custom writers.

• RST, Markdown writers: Fixed rendering of grid tables with blank rows(#2615).

• LaTeX writer: restore old treatment of Span (#2624). A Span isnow rendered with surrounding {}, as it was before 1.16.

• Entity handling fixes: improved handling of entities like⟨ that require a trailing semicolon. Allow uppercasex in numerical hexidecimal character references, workingaround a tagsoup bug.

• stack.yaml - use lts-4.0, but with older aeson to avoid excessivememory use on compile. With aeson 0.10 we were getting an out ofmemory error on a 2GB Ubuntu 64-bit VM.

• Improved deb package creation script. Made DPKGVER work.Renamed COMMIT to TREE. You should now be able to doTREE=1.16.0.1 DPKGVER=2 make deb.

pandoc 1.16 (2016-01-02)

• Added Attr field to Link and Image (Mauro Bieg, #261, API change).

  • Added syntax for link and image attributes to pandoc's Markdown.
  • Updated readers and writers to use link and image attributeswhen appropriate.
  • Support image attributes in Docx, Textile, RST readers.

• Renamed link attribute extensions. The old link_attributes isnow mmd_link_attributes, and link_attributes now enables thenew pandoc-style link and image attributes (API change).Note: this change could break some existing workflows.

• Implemented SoftBreak and new --wrap option (#1701, API change).Added threefold wrapping option.

  • Command line option: deprecated --no-wrap, added--wrap=[auto|none|preserve]
  • Added WrapOption, exported from Text.Pandoc.Options
  • Changed type of writerWrapText in WriterOptions fromBool to WrapOption.
  • Modified Text.Pandoc.Shared functions to allow SoftBreak.
  • Supported SoftBreak in readers and writers.

• Text.Pandoc.Options: Added writerDpi to WriterOptions (APIchange, Mauro Bieg).

• Added --dpi command-line option (Mauro Bieg).

• Rationalized behavior of --no-tex-ligatures and --smart (#2541).This change makes --no-tex-ligatures affect the LaTeX readeras well as the LaTeX and ConTeXt writers. If it is used,the LaTeX reader will parse characters `, ', and -literally, rather than parsing ligatures for quotation marksand dashes. And the LaTeX writer will print unicode quotationmark and dash characters literally, rather than convertingthem to the standard ASCII ligatures. Note that --smart hasno effect on the LaTeX reader. --smart is still the defaultfor all input formats when LaTeX or ConTeXt is the output format,unless --no-tex-ligatures is used.

  Some examples to illustrate the logic:

  % echo "'hi'" | pandoc -t latex`hi'% echo "'hi'" | pandoc -t latex --no-tex-ligatures'hi'% echo "'hi'" | pandoc -t latex --no-tex-ligatures --smart‘hi’% echo "'hi'" | pandoc -f latex --no-tex-ligatures<p>'hi'</p>% echo "'hi'" | pandoc -f latex<p>’hi’</p>

• Removed deprecated options --offline and --html5.

• Fixed language code for Czech (cs not cz) (#2597).

• Implemented east_asian_line_breaks extension (#2586).In Text.Pandoc.Options, added Ext_east_asian_line_breaks constructorto Extension (API change). This extension is likeignore_line_breaks, but smarter -- it only ignores line breaksbetween two East Asian wide characters. This makes it better suitedfor writing with a mix of East Asian and non-East Asian scripts.

• Added support for PDF creation via wkhtmltopdf.To use this: pandoc -t html5 -o result.pdf (and add --mathjaxif you have math.) Margins can be set using the variablesmargin-top, margin-bottom, margin-left, margin-right.Other styling can be done through CSS.

• Fixed cite key parsing regression (jgm/pandoc-citeproc#201).We were capturing final colons as in [@foo: bar]; the citation idwas being parsed as @foo:.

• ICML writer:

  • Fixed image syntax for local files (#2589).
  • Changed type of writeICML (Mauro Bieg).API change: It is now WriterOptions -> Pandoc -> IO String.Also handle new image attributes.
  • Intersperse line breaks instead of appending them toevery ParagraphStyleRange (Mauro Bieg, #2501).
  • Add Cite style to citations (Mauro Bieg).
  • Added figure handling (#2590, Mauro Bieg).
  • Better handling of math. Instead of just printing the raw tex,we now try to fake it with unicode characters.

• HTML writer: Include example class for example lists (#2524).

• ODT/OpenDocument writer: improved image attributes (Mauro Bieg).

  • Support for percentage widths/heights
  • Use Attr instead of title to get dimensions from ODT walkerto writeOpenDocument.

• AsciiDoc writer:

  • Support anchors in spans and divs with id elements(jgm/pandoc-citeproc#143).
  • Fixed code blocks (#1861).

• Haddock writer: omit formatting inside links, which isn't supportedby Haddock (#2515).

• MediaWiki writer: Fixed spacing issues in table cells.

  • Start cell on new line unless it's a single Para or Plain(#2606).
  • For single Para or Plain, insert a space after the | toavoid problems when the text begins with a character like- (#2604).

• Beamer writer: mark frame as fragile when it contains verbatim (#1613).

• LaTeX writer:

  • Add support for GAP highlighting using listings (Raniere Silva).
  • Consider header-includes content as well as templateswhen determining whether to use csquotes (Andreas Lööw).
  • Create defaults for geometry using margin-left etc.If geometry has no value, but margin-left, margin-right,margin-top, and/or -margin-bottom are given, a default valuefor geometry is created from these. Note that these variablesalready affect PDF production via HTML5 with wkhtmltopdf.

• ConTeXt writer: set default layout based on margin-left, etc.This sets up \setuplayout based on the variables margin-left,margin-right, margin-bottom, and margin-top, if no layoutis given.

• Docx writer: better handling of PDF images. Previously we triedto get the image size from the image even if an explicit size wasspecified. Since we still can't get image size for PDFs, this madeit impossible to use PDF images in docx. Now we don't try to getthe image size when a size is already explicitly specified.

• Markdown writer: use raw HTML for link/image attributes whenthe link_attributes extension is unset and raw_html is set (#2554).

• MediaWiki reader: interpret markup inside <tt>, <code> (#2607).

• LaTeX reader:

  • Improved smart quote parsing (#2555). This fixes redering ofunmatched quotes.
  • Use curly quotes for unmatched ` (#2555).
  • Allow blank space between braced arguments of commands (#2592).

• Markdown reader:

  • Improved pipe table relative widths. Previously pipe tablecolumns got relative widths (based on the header underscore lines)when the source of one of the rows was greater in width than thecolumn width. This gave bad results in some cases where much ofthe width of the row was due to nonprinting material (e.g. linkURLs). Now pandoc only looks at printable width (the width of aplain string version of the source), which should give better results.Thanks to John Muccigrosso for bringing up the issue.
  • Fixed parsing bug with macros. Previously macro definitions inindented code blocks were being parsed as macro definitions, not code.

• Textile reader: skip over attribute in image source (#2515).We don't have a place yet for styles or sizes on images, butwe can skip the attributes rather than incorrectly taking themto be part of the filename.

• Docx reader: Handle dummy list items (Jesse Rosenthal).These come up when people create a list item and then delete thebullet. It doesn't refer to any real list item, and we used to ignoreit.

• CommonMark reader/writer rewritten to use latest cmark.

• Fixed Emoji character definitions (#2523). There were many bugs in thedefinitions.

• Text.Pandoc.CSS:

  • Added pickStylesToKVs function to extract multiple properties atonce (API change, Mauro Bieg).
  • Parse CSS that doesn't contain the optional semicolon (Mauro Bieg).

• trypandoc: sort drop-down lists.

• Beamer template:

  • Made \euro conditional on presence of character.for xelatex and lualatex, as it is for pdflatex (Andrew Dunning).
  • Moved header-includes before setting of title (Thomas Hodgson),to match the LaTeX template (jgm/pandoc-templates#168).
  • Added section-titles variable (defaults to true)to enable/suppress section title pages in beamerslide shows (Thomas Hodgson).
  • Moved beamer themes after fonts, so that themes canchange fonts. (Previously the fonts set were beingclobbered by lmodern.sty.) (Thomas Hodgson).

• Beamer/LaTeX template changes (Thomas Hodgson):

  • Added thanks variable
  • Use parskip.sty when indent isn't set (fall back to usingsetlength as before if parskip.sty isn't available).
  • Use biblio-style with biblatex.
  • Added biblatexoptions variable.

• LaTeX template changes:

  • Added paper after $papersize$ variable in latex template.Thus you can say papersize: a4 and the latex will containa4paper. This change may break some existing workflows; ifyou currently specify a4paper, you'll get a4paperpaper whichis meaningless. However, the change seems worth it, as it willmake the papersize variable work uniformly across ConTeXt, LaTeX,and html->pdf via wkhtmltopdf.
  • Only pass options to color package if colorlinks is set(Andrew Dunning).
  • Make definition of \euro conditional in xelatex/lualatex,as it is already for pdflatex (Andrew Dunning).
  • Removed setting of subject in PDF metadata.This used to be set to the subtitle, but really the subtitleneed not give the subject. Also, subtitle can contain formatting,so we'd need, at least, a plain text version for this.
  • Moved header-includes before setting of \title, \author,etc. This allows these macros to be redefined.
  • Use \subtitle command for subtitle, instead of tacking iton to the title as before. We give a no-op fallback definition if itis not defined. This change should produce much better resultsin classes that support \subtitle. With the default articleclass, which does not define \subtitle, subtitles will nolonger be printed unless the user defines \subtitle andredefines \maketitle.
  • Moved redefinitions of \paragraph and \subparagraph tobefore header-includes.

• Context template:

  • Use simplefonts for font loading (Paolo Rodríguez). This isneeded for things to work on ConTeXt stable from TeXLive 2015.
  • Revert use of \setuphead in title block (Andrew Dunning,Rik Kabel).

• Update LaTeX/ConTeXt link colour usage (Andrew Dunning).

• Fixed man template so disabling hyphenation actually works.The command needs to come after .TH.

• Added 'navigation' variable to beamer template (#2543).Valid values are empty (the default), horizontal, vertical,and frame. Note that this changes the default behavior fromhorizontal to empty. Closes #2543.

• Added toc to HTML slide format templates (Andrew Dunning),so that --toc creates a contents slide.

• Added stack.full.yaml to build pandoc-citeproc as well.

• Allow pipe tables with no body rows (#2556).Previously this raised a runtime error.

• Shared: Improved fetchItem so that C:/Blah/Blah.jpg isn't treatedas URL. The Haskell URI parsing routines will accept "C:" as ascheme, so we rule that out manually. This helps with--self-contained and absolute Windows paths.

• Define a meta-json variable for all writers (#2019). This containsa JSON version of all the metadata, in the format selected for thewriter. So, for example, to get just the YAML metadata, you can runpandoc with the following custom template: $meta-json$. The intentis to make it easier for static site generators and other tools to getat the metadata.

• Document limitations of --self-contained (#2553).

• Improved Citations section of README (#2551). Added informationabout link-citations and a link to the pandoc-citeproc man page.

• ImageSize: use safeRead instead of readMaybe, which isn'tin base < 4.6.

• Allow .adoc file extension for AsciiDoc (Andrew Dunning).

• Improved implicit pandoc-citeproc inclusion.The filter pandoc-citeproc is automatically used when--bibliography is specified on the command line, unless--natbib or --biblatex is used. However, previously thisonly worked if --bibliography was spelled out in full, and notif --biblio was used.

• reveal.js: Interpret pauses correctly for all headers (#2530).Previously, when using headers below the slide level, pauses are leftuninterpreted into pauses. In my opinion, unexpected behavior butintentional looking at the code.

• Remove redundant center variable for reveal.js (Andrew Dunning).

• Parsing: Add extractIdClass, modified type of KeyTable (MauroBieg, API change).

• ImageSize: Added functions for converting between image dimensions(Mauro Bieg).

• Use lts-3.18 in stack.yaml. This avoids Windows buildissues with the HTTP library.

• Bump version bounds for dependencies.

pandoc 1.15.2.1 (2015-11-16)

• Added two missing test files, and stack.yaml, toextra-source-files so they're included in the source tarball.

• reveal.js template: Fixed parallaxBackground options.parallaxBackgroundHorizontal and parallaxBackgroundVerticalneed integer values, not strings. (Vaughn Iverson)

pandoc 1.15.2 (2015-11-15)

• pandoc my.md -t context -o my.pdf will now create a PDF usingConTeXt rather than LaTeX (#2463).

• Fixed omitted url(...) in CSS data-uri with --self-contained (#2489).

• Added emoji Markdown extension, enabled by default in markdown_github(#2523). Added Ext_emoji to Extension in Text.Pandoc.Options(API change).

• Text.Pandoc.Readers.HTML.parseTags: Fixed over-eager raw HTML inlineparsing (#2469). Tightened up the inline HTML parser so it disallowsTagWarnings.

• Derive Generic instances for the types in Text.Pandoc.Options.

• Org reader:

  • Fix paragraph/list interaction (Albert Krewinkel, #2464).Paragraphs can be followed by lists, even if there is no blank linebetween the two blocks. However, this should only be true if theparagraph is not within a list, were the preceding block should beparsed as a plain instead of paragraph (to allow for compact lists).Thanks to @rgaiacs for bringing this up.
  • Allow toggling header args (Albert Krewinkel, #2269).Org-mode allows to skip the argument of a code block header argument ifit's toggling a value. Argument-less headers are now recognized,avoiding weird parsing errors.
  • Fix markup parsing in headers (Albert Krewinkel, #2504).Markup as the very first item in a header wasn't recognized. This wascaused by an incorrect parser state: positions at which inline markupcan start need to be marked explicitly by changing the parser state.This wasn't done for headers. The proper function to update the stateis now called at the beginning of the header parser, fixing this issue.
  • Fix emphasis rules for smart parsing (Albert Krewinkel, #2513).Smart quotes, ellipses, and dashes should behave like normal quotes,single dashes, and dots with respect to text markup parsing.
  • Require whitespace around definition list markers (#2518).This rule was not checked before, resulting in bugs with footnotesand some link types.

• Markdown reader:

  • Pipe tables with long lines now get relative cell widths (#2471).If a pipe table contains a line longer than the column width (as set by--columns or 80 by default), relative widths are computed based on thewidths of the separator lines relative to the column width. This shouldsolve persistent problems with long pipe tables in LaTeX/PDF output, andgive more flexibility for determining relative column widths in otherformats, too. For narrower pipe tables, column widths of 0 are used,telling pandoc not to specify widths explicitly in output formats thatpermit this.
  • Improved parser for mmd_title_block. We now allow blank metadatafields. These were explicitly disallowed before.
  • Citation keys can now contain ://, so URLs and DOIs can be usedas citation keys (jgm/pandoc-citeproc#166).

• Beamer template: fix incompatibility of section slides with natbib.Natbib (and presumably biblatex) bibliography commands createtheir own section. Since these are in frame environments,we have an incompatibility with the \AtBeginSection macrowhich creates a special frame when a new section occurs.(We can't have a frame inside another frame.) This change disables\AtBeginSection inside bibliography slides. Thinks to Yihui Xie forbringing the problem to my attention. This supersedes #145. Seediscussion there.

• Textile reader: don't do smart punctuation unless explicitly asked(#2480). Note that although smart punctuation is part of the textilespec, it's not always wanted when converting from textileto, say, Markdown. So it seems better to make this an option.

• LaTeX reader: Handle comment environment (Arata Mizuki).The comment environment is handled in a similar way to theverbatim environment, except that its content is discarded.

• Docx reader: Follow relationships correctly in foot/endnotes (#2258,Jesse Rosenthal). This fixes a problem with links in notes.

• LaTeX and ConTeXt writers: support lang attribute on divs and spans(mb21). For LaTeX, also collect lang and dir attributes on spans anddivs to set the lang, otherlangs and dir variables if they aren’t setalready. See #895.

• LaTeX writer:

  • Use proper command for \textarabic (mb21).
  • Added de-CH-1901, fixed el-polyton in toPloyglossia (Nick Bart).
  • Use \hypertarget and \hyperlink for links. This works correctlyto link to Div or Span elements. We now don't bother defining \labelfor Div or Span elements. Closes jgm/pandoc-citeproc#174.
  • Avoid footnotes in list of figures (#1506).
  • Properly handle footnotes in captions (#1506).
  • Add \protect to \hyperlink (#2490). Thanks to Hadrien Mary.
  • Set colorlinks if linkcolor, urlcolor, citecolor, ortoccolor is set (#2508).

• Textile writer: support start number in ordered lists (#2465).

• OpenDocument writer: Allow customization of opendocumentautomatic styles. Automatic styles can now be inserted in thetemplate, which now provides the enclosing <office:automatic-styles>tags (#2520).

• Docx writer: insert space between footnote reference and note (#2527).This matches Word's default behavior.

• EPUB writer: don't download linked media when data-external attributeset (#2473). By default pandoc downloads all linked media and includes itin the EPUB container. This can be disabled by setting data-external onthe tags linking to media that should not be downloaded. Example:

  <audio controls="1"> <source src="http://www.sixbarsjail.it/tmp/bach_toccata.mp3" type="audio/mpeg"></source></audio>

• HTML writer: use width on whole table if col widths sum to < 100%.Otherwise some browsers display the table with the columnsseparated far apart.

• AsciiDoc template: Fix author and date; add keywords,abstract (Andrew Dunning).

• HTML-based templates (Andrew Dunning):

  • Use en dash instead of hyphen between title prefix and title.
  • Add keywords to metadata.
  • Add lang, dir, quotes where missing.
  • Always make author and date display conditional.
  • Updated dzslides template from source.

• Man template: make "generated by" comment conditional.

• LaTeX, Beamer templates:

  • Add babel-otherlangs for language divs/spans; babel-newcommands,filled by commands that make babel understand the polyglossia-stylelanguage directives (mb21, #137).
  • Improved formatting of conditionals; $for$ is always provided to allowmultiple options (Andrew Dunning, #141).
  • Use Ligatures=TeX rather than Mapping=tex-text with fontspecto improve support for LuaTeX (Andrew Dunning, #135).
  • Revise hyperref usage (Andrew Dunning, #139, #141):
    • use same options for all LaTeX engines;
    • add subtitle and keywords to PDF metadata;
    • do not override hyperref link coloring without user input, effectively makingthe hidelinks option the default (removed as a separate variable);
    • link colors can be enabled (using a slightly darker version of the olddefaults) using a new colorlinks variable, automatically used bythe LaTeX writer when custom colors are specified;
    • pdfborder={0 0 0} is automatically set by hyperref withcolorlinks, and is only applied if colorlinks is disabled.

• ConTeXt template (Andrew Dunning):

  • New variables for controlling styles: linkstyle, linkcolor,linkcontrastcolor, layout, pagenumbering, whitespace, indenting,interlinespace, headertext, footertext, mainfont, sansfont,monofont, mathfont, fontsize.
  • Default template no longer supports MkII.
  • Improve writing of title block (suppressing numbering of first page).
  • Add title subtitle, author, date, keywords to PDF metadata.
  • Support subtitle, abstract.
  • Support list of figures (lof), list of tables (lot).
  • Disable link styling by default.
  • Define styles for all section types.
  • Enable microtype.
  • Improved formatting of conditionals.

• Beamer template: added code to prevent slide breaks inside paragraphs(#2422, thanks to Nick Bart). This will matter, in practice, only whenallowframebreaks is used. It is especially helpful for bibliographyslides.

• OpenDocument template: Add <office:automatic-styles> tag aroundautomatic styles. The writer now longer provides this (see #2520).

• Restored Text.Pandoc.Compat.Monoid.

• Do not export (<>) from custom Prelude. The Prelude now matchesbase 4.8 Prelude's API.

• Don't use custom prelude with ghc 7.10. Use the custom preludeonly for earlier versions. This change makes stack ghci andcabal repl work (#2503), at least with ghc 7.10.

• Changed § to % in operators from Odt.Arrows.Utils (#2457).This prevents problems building haddocks with "C" locale.

• Change default for old-locale flag to False.

• Use stack in deb, osx, and Windows package generators.

• Added Vagrantfile for building deb in vm.This should help in automating binary package creation. 'make package'will make the package. 'make package COMMIT=blah' will make the packagefrom commit blah.

• README:

  • Consistent capitalization for pandoc and Markdown.
  • Fixed auto_identifiers examples (Benoit Schweblin).
  • Improved documentation of template variables (Andrew Dunning).