summaryrefslogtreecommitdiff
path: root/macros/generic/markdown/CHANGES.md
diff options
context:
space:
mode:
Diffstat (limited to 'macros/generic/markdown/CHANGES.md')
-rw-r--r--macros/generic/markdown/CHANGES.md850
1 files changed, 850 insertions, 0 deletions
diff --git a/macros/generic/markdown/CHANGES.md b/macros/generic/markdown/CHANGES.md
new file mode 100644
index 0000000000..e409961301
--- /dev/null
+++ b/macros/generic/markdown/CHANGES.md
@@ -0,0 +1,850 @@
+# Changes
+
+## 2.16.0 (2022-08-26)
+
+Development:
+
+- Add support for strike-throughs, fenced divs, inline spans, subscripts,
+ superscripts, and fancy lists. (#149, #160, #162, #168, #170)
+- Add facade in front of expl3 inferface for YAML metadata. (#118, #175)
+- Add `\setupmarkdown` and `\inputmarkdown` commands to ConTeXt. (#17, #176)
+
+Fixes:
+
+- Make any ASCII character escapable as per
+ [CommonMark](https://spec.commonmark.org/0.30/#backslash-escapes).
+ (#163)
+- Make our implementation of header attributes compatible with jgm/lunamark.
+ (#164, #177)
+
+Documentation:
+
+- Add file `CHANGES.md` with the changelog of the Markdown package.
+- Add badges for Matrix.org and Discord chat spaces. (2f1104d..acdc989)
+- Add a link to @xvrabcov's TUG 2022 talk, slides, and example documents to the
+ README. (d422f5c)
+
+Proposals:
+
+- Propose support for user-defined syntax extensions. (#172, #174)
+
+Continuous Integration:
+
+- Ignore changes to `**/README.md`. (e39a7aa)
+
+## 2.15.4 (2022-07-29)
+
+Fixes:
+
+- In `parsers.specialchar`, only include special characters of enabled syntax
+ extensions. (#150, #152)
+- Avoid nesting `\markdownIfOption`. (#151)
+- Make the `\markdownSetup` and `\markdownSetupSnippet` commands accept `\par`
+ tokens. (#130)
+
+Deprecation:
+
+- Deprecate TeX Live 2019. (5c861e3)
+
+Refactoring:
+
+- Replace `xstring` with `l3str`. (contributed by @drehak, #96, #153)
+- Replace `keyval` with `l3keys` (contributed by @drehak, #96, #155, #157)
+
+Continuous Integration:
+
+- Add Luacheck. (#154)
+
+## 2.15.3 (2022-06-29)
+
+Refactoring:
+
+- Add a mechanism for extending the Markdown reader and the LaTeX writer.
+ (#138, #143)
+- Separate the Lua shell escape bridge into [the `lt3luabridge`
+ package](https://github.com/witiko/lt3luabridge). (#140, #141)
+- Add further reflection capabilities. (#124, #137)
+
+Contributed Software:
+
+- Update `contributions/book-templates`. (contributed by @xvrabcov, b4d892c,
+ a6d5c77)
+
+Deprecation:
+
+- The `\markdownOptionHelperScriptFileName` command will be removed in Markdown
+ 3.0.0. (#141)
+- The `\markdownOptionOutputTempFileName` command will be removed in Markdown
+ 3.0.0. (#141)
+- The `\markdownOptionErrorTempFileName` command will be removed in Markdown
+ 3.0.0. (#141)
+- The `\markdownMode` command will be removed in Markdown 3.0.0. (#141)
+
+Docker:
+
+- Remove `latest-with-cache` tag from Docker images. (04301f0)
+
+Documentation:
+
+- Remove disfunctional badges for Docker from `README.md`. (ad00b58, 707cad9)
+- Link to TUG's version of the TUG 2021 video in `README.md`. (1462411)
+
+Miscellaneous:
+
+- As of today, Markdown has 234 stars, 56 forks, and 7 watchers on GitHub. 🥂
+
+## 2.15.2 (2022-06-01)
+
+Documentation:
+
+- Document that no `eagerCache` makes recursive nesting undefined behavior.
+ (a486b88)
+- Fix typos in the documentation. (03a172a, ab3ad8d)
+
+Contributed Software:
+
+- Update `contributions/book-templates`. (contributed by @xvrabcov, 8c56288,
+ 78af2fd, b238dbc)
+- Update `contributions/pandoc-to-markdown`. (contributed by @drehak, 7cc7edc,
+ 2e7ccfe)
+- List @TeXhackse's [document templates](https://gitlab.com/l4070) in
+ `contributions/README.md`.
+
+Continuous Integration:
+
+- Fix a typo in `Makefile` that made it impossible to recover from `pkgcheck`
+ errors. (33c8c99)
+
+## 2.15.1 (2022-05-18)
+
+Fixes:
+
+- Only let LaTeX's default link renderer prototype produce `\ref` for relative
+ autolinks (discovered by @drehak, 7f3fd9b, #127)
+- Ensure that `cacheDir` exists in `witiko/graphicx/http` LaTeX theme.
+ (discovered by @drehak, 5145954, #128)
+
+Documentation:
+
+- Fix a typo in the documentation. (5e3b149)
+- Add a link to a preprint from TUGboat 43(1) to the README. (authored by
+ @witiko, @drehak, @michal-h21, and @xvrabcov, 7d47780, e9c7bfc)
+- Only use the emoji package in TeX Live 2020 and later. (a46ffd2..a8e5838)
+
+Contributed Software:
+
+- Update `contributions/book-templates`. (contributed by @xvrabcov, 9f51cb4,
+ 8d6e5d6)
+- Update `contributions/pandoc-to-markdown`. (contributed by @drehak, ac82a5f,
+ 102b1a5)
+- Add contributions/doctoral-thesis. (a8fbd97)
+
+Continuous Integration:
+
+- Add TL2021-historic image to the continuous integration. (a9e3b08)
+
+## 2.15.0 (2022-03-31)
+
+Development:
+
+- Add reflection to the TeX implementation. (#119, 73f699b..30ee46d, 02dd30a)
+- Add an option to include arbitrary YAML documents. (#117, 78dc62b..93246a4)
+- Move expl3 interface for YAML metadata from LaTeX to plain TeX.
+ (1ec7931..95d83ba)
+- Add LaTeX `\markdownIfSnippetExists` command. (929137a)
+- Add code key to LaTeX `\markdownSetup` command. (ef53fae)
+
+Contributed Software:
+
+- Add a proof-of-concept of integration Markdown with Pandoc. (contributed by
+ @drehak, #25, c40b51c)
+- Add LaTeX themes for typesetting books and marketing colaterals. (contributed
+ by @xvrabcov, #104, a7d6d2e)
+
+Fixes:
+
+- Use current theme name to resolve `\markdownSetup{snippet = ...}`. (0c79a80)
+
+Documentation:
+
+- Add directory `contributions/` with contributed third-party software.
+ (contributed by @drehak and @xvrabcov, c40b51c..9296cf1)
+- Fix formatting gaffes in the documentation. (97dee2f)
+- Remove an extra backslash in the user manual. (994d06f)
+- Move `<link>` element out of the technical documentation. (18b6241)
+
+## 2.14.1 (2022-03-01)
+
+Fixes:
+
+- Fix default LaTeX renderer prototypes for block HTML comments. (b933d81)
+
+## 2.14.0 (2022-02-28)
+
+Fixes:
+
+- Track nested LaTeX themes with a stack. (69478c0, 00c3e6a)
+
+Development:
+
+- Add renderers for inline HTML tags, block HTML elements, and block HTML
+ comments. (#90, e5e28ed, 44affc3)
+- Add renderers for heading attributes. (#87, #91, cad83f6)
+- Add `relativeReferences` Lua option for writing relative autolinks such as
+ `<#some-section>`. (#87, #91, e7267c0)
+
+Documentation:
+
+- Change category code of percent sign (`%`) before `\input`ting the output of
+ `markdown-cli` in LaTeX and ConTeXt examples. (a61e371, 9635d76)
+
+Quality of Life:
+
+- Emit an error message when an undefined LaTeX setup snippet is invoked.
+ (9d25074)
+- Add a trailing newline to the output of `markdown-cli`. (80b7067)
+
+Default Renderer Prototypes:
+
+- Do not use image alt text to produce labels in renderer prototypes. (reported
+ by @writersglen, 1c31c01)
+- Pass HTML through to TeX4ht. (contributed by @michal-h21, #90, 2f5dcba)
+- Be lazy about what commands to use for default LaTeX table rules.
+ (contributed by @michal-h21, #90, 03a444a)
+
+Continuous Integration:
+
+- Retry failed `pkgcheck --urlcheck` in `Makefile`. (3c31baf)
+- Always upload artifacts, even outside the `main` branch. (24feb6a)
+
+## 2.13.0 (2022-01-30)
+
+Fixes:
+
+- Disable the parsing of timestamps in YAML metadata. (contributed by
+ @TeXhackse, 75f6f20, 7d18b58, a27fdd9, #116)
+
+Development:
+
+- Add [markdown document
+ renderers](https://witiko.github.io/markdown/#markdown-document-renderers).
+ (2199c22, 4a70b04, #109)
+- Add an example document for ConTeXt MkIV. (8bbb6ab, #17)
+
+Default Renderer Prototypes:
+
+- Redefine default LaTeX `codeSpan` renderer prototype to work in math mode.
+ (35b53d3, e68a631)
+- Support the unicode-math LaTeX package. (9d840be, #110)
+
+Continuous Integration:
+
+- Produce artefacts and GitHub pages only for the `latest` Docker tag.
+ (976f074)
+- Only push the latest Docker image once. (cc78fa1)
+- Add `--urlcheck` option to the `pkgcheck` command in `Makefile`. (3b4d6a1,
+ d9b2a01)
+
+Docker:
+
+- Show the size of the latest Docker image in the `README`. (1f680a8)
+
+## 2.12.0 (2021-12-30)
+
+Fixes:
+
+- Add default definition for `\markdownRendererJekyllDataSequenceEnd`.
+ (6c4abe3)
+
+Development:
+
+- Preserve trailing spaces in ConTeXt MkIV. (#101)
+- Add `eagerCache` Lua option. (#102)
+- Add `hardLineBreaks` Lua option. (#98)
+
+Documentation:
+
+- Document how we can set Lua options from plain TeX and both Lua options and
+ plain TeX options from LaTeX (#105)
+- Update link to TUGboat 42(2) article from preprint to archival version.
+ (715f53c)
+- Add two articles from the CSTUG Bulletin 2021/1-4 to the README. (76da1d6)
+- Escape percent signs in code examples in techdoc (7d6ca54)
+
+Default Renderer Prototypes:
+
+- Make content blocks automatically `\input` TeX files. (c798106)
+
+Docker:
+
+- Build and publish Docker images for historical TeX Live versions. (#111)
+
+## 2.11.0 (2021-10-01)
+
+Fixes:
+
+- Remove a spurious print when handling the `texComments` Lua option. (4ee94ec)
+- Escape `escaped_minimal_strings` even in `hybrid` mode. (c1fd53b)
+- Make assignments in `writer->set_state()` and `writer->defer_call()` local.
+ (9261349)
+- Don't let default LaTeX renderer prototype for `ulItem` gobble next token.
+ (reported by @writersglen, 8d8023f)
+- In LaTeX, prevent `\@ifundefined` from making `\markdownOptionTightLists`
+ into `\relax`.
+- Fix even backslashes before newline being gobbled by the `texComments` Lua
+ option. (9ca0511)
+
+Development:
+
+- Add [`taskLists` Lua
+ option](https://witiko.github.io/markdown#option-tasklists) for writing task
+ lists. (suggested by @xvrabcov, #95)
+- Add [`jekyllData` Lua
+ option](https://witiko.github.io/markdown#option-jekylldata) for writing YAML
+ metadata. (contributed by @TeXhackse, #22, #77)
+
+Documentation:
+
+- Add a link to @witiko's TUG 2021 talk, preprint, and slides to the README.
+ (4b89f84, 6f61e48, 745a6f3, 99b1041, 872fb4d)
+- Add a cornucopia of badges to the README. (60f7033, 8e9a34c)
+- Use HTTPS links for CTAN in the README. (b068b65, a743b06)
+- Use emoji in the technical documentation. (ccfcaf4)
+- Add block and sequence diagrams to the technical documentation. (6168473,
+ 0b4bb91, 5fd2e19, 3b4af9c, 4e99cb9, cbccf36, a7f9a60, 48d5a21)
+- Add index to the technical documentation. (3ee5a99, 32d93e8)
+- Add a list of figures to the technical documentation. (48d5a21)
+- Use varioref in the technical documentation. (2f8e85e)
+- Describe Lua command-line interface (CLI) in the README. (ba27b51, 1ad85a2)
+- Publish user manual to [GitHub Pages](https://witiko.github.io/markdown).
+ (4a812a4, 4f1f349)
+- Document that the `hybrid` option is `false` by default. (955d7c1)
+- Show how
+ [`tugboat.bib`](http://mirrors.ctan.org/info/digests/tugboat/biblio/tugboat.bib)
+ can be used to cite the Markdown package. (7e20eee)
+
+Continuous Integration and Distribution:
+
+- Rename `master` branch to `main`. (513de1f)
+- Make `make implode` clean up auxiliary markdown files. (fe25ae9)
+- Add `Dockerfile` and make continuous integration use Docker image. (#97,
+ cbc0089, f64bfa5, 8a7b656, e185547, 1bb7075)
+- Rebuild the Docker image every Monday at 4:30AM (UTC). (c9f87a9, 28b0e93)
+- Automatically prerelease the latest version. (cd7fbd2)
+- Use MarkdownLint in continuous integration. (2440659, aa1e14b)
+- Test Lua command-line interface in continuous integration. (6a84f98, 4e28ef0)
+- Matrix-test all supported TeX Live versions. (69b9edc)
+
+## 2.10.1 (2021-08-31)
+
+Fixes:
+
+- Always enable `texComments` when `hybrid` is enabled. (715d025)
+- Make the preprocessor of TeX comments surjective. (6021dd5)
+
+## 2.10.0 (2021-08-07)
+
+Fixes:
+
+- String text and parenthetical citations. (e6026c1)
+- Escape autolink labels even when hybrid mode is enabled. (repored by @iwelch,
+ 693e134)
+- Protect LaTeX strong emphasis renderer prototype and make it detect font.
+ (reported by @iwelch, 89a031a)
+- Let users name their documents `markdown.tex`. (reported by @mmarras, cb50d4,
+ 9d21141)
+- Support deferred content (footnotes, links, and images) with slicing.
+ (edbdced)
+- Support tables with slicing. (5a61511)
+- Increment `markdownFrozenCacheCounter` globally. (c151cbc)
+- Change the category code of the percent sign to other in `\markdownInput`.
+ (b21fac4, 4d025e1, 5b1625f, 6f24307)
+- Add `\startmodule` command to the ConTeXt module. (9f2ec1d)
+- Add a missing `local` qualifier to the definition of a local variable.
+ (1153afb)
+- Don't allow LaTeX list item renderers to consume surrounding text. (reported
+ by @nbubis, cb79225)
+
+Development:
+
+- Add the `theme` LaTeX option. (39ab6f3, 8699eb4, a1ae258, ea9c237, 3740742,
+ 67aaf40)
+- Add the `stripIndent` Lua option. (b94dda5, 5757067, 654624c)
+- Add the `texComments` Lua options. (c439a0f, 5f7c5e3, 744bcdb, 1ec06f4,
+ b74fd01, 2dd76f1)
+- Add support for LuaMetaTeX. (f004170, 905c832, 575a1e0, f93a353)
+- Add the `inlineHtmlComment` renderer. (bf54b2f)
+- Add the `plain` LaTeX package option. (af9c0d6)
+- Add the `snippet` LaTeX option. (b43024f, 438f075, 2960810)
+
+Debugging:
+
+- Add helpful messages to read/write errors. (contributed by @drehak, d22cd25)
+- Make ConTeXt/LaTeX use their info/warning/error commands during loading.
+ (a638a91)
+
+Documentation:
+
+- Remove deprecated filecontents package from examples. (dd2dc1c)
+- Fix a typo in the user manual. (13f056)
+- Fix code style in the user manual. (416c24e)
+- Update out-of-date-documentation. (713ec92)
+- Add *Making Markdown into a Microwave Meal* article into the README.
+ (4698224)
+- Add a link to @witiko's PV212 talk to the README. (e5e8708)
+- Fix overlong lines in the documentation. (34e9f4f)
+- Update installation documentation. (b3957a8)
+- Fix a typo in the documentation of `expandtabs`. (3e55507)
+- Remove unnecessary `footnotes` option from the `inlineFootnotes` example.
+ (30792ef)
+- Fix a typo in the documentation of `\markdownRendererOlItemWithNumber`.
+ (d05df9d)
+- Fix errors in the documentation markup. (a6a0059)
+- Remove multiply-defined refs in documentation. (ab99a30)
+
+Licensing:
+
+- Bump the copyright year. (9462f17)
+- Sublicense the code as LPPL v1.3c. (609aeee)
+
+Unit tests:
+
+- Remove xtrace from `test.sh` for less verbose output. (b307ee6)
+- Treat all files as text with GNU diff in `test.sh`. (ec89e6d)
+- Print full TeX log when there is an error in a unit test. (7640c20)
+
+Distribution:
+
+- Add `banner.png` to the CTAN distribution. (fe107d6)
+- Add base `Makefile` target. (41ab71a)
+
+Continuous integration:
+
+- Convert CircleCI configuration to GitHub Actions workflow. (0f77bc5)
+- Add shellcheck. (27e825b)
+- Upload artifacts in GitHub Actions workflows. (12e3585, e696d41)
+- Install Graphviz in continuous integration. (3ebf0c9, 4ef340c)
+- Test that the number of pages in typeset documentation is sane. (048b7fc)
+
+Miscellanea:
+
+- Use `\@ifdefined` and `\@onlypreamble` in LaTeX code. (40b77f4)
+
+## 2.9.0 (2020-09-14)
+
+Development:
+
+- Add support for finalizing and freezing the cache.
+
+Fixes:
+
+- Fix default definition of `markdownRendererAmpersandPrototype`.
+- Remove redundant `\label` in contentBlocks LaTeX renderer prototype.
+- Make LaTeX and ConTeXt implementations also expand `\markdownEnd`.
+- Fortify I/O in Lua with additional asserts.
+
+Documentation:
+
+- Fix links in the documentation.
+- Fix typos in the documentation.
+- Remove deprecated `filecontents` package.
+- Do not use package `xcolor`.
+- Add blank lines to `README.md`.
+- Add Citing Markdown section to `README.md`.
+- Add banner to `README.md`.
+- Cite new CSTUG Bulletin article.
+
+Continuous integration:
+
+- Use TeX Live 2020.
+
+Miscellanea:
+
+- Update distribution packaging according to CTAN requirements.
+
+## 2.8.2 (2020-03-20)
+
+Fixes:
+
+- Add example-image.png to the Git repository (closes issue #49).
+- Require that text citations are not preceded by non-space characters.
+- Add a line ending at the end of markdown file in case there is none.
+- Do not assume `\markdownInput` input comes from `\markdownOptionOutputDir`
+ (closes issue #57).
+
+Documentation:
+
+- Extend the abstract of the Markdown package.
+- Document continuous integration and the Makefile.
+- Properly highlight the syntax of shell commands in user manual.
+- Add CSTUG bulletin articles to the README.
+
+Miscellanea:
+
+- Upgrade continuous integration from TeX Live 2019 to TeX Live 2020 pretest.
+
+## 2.8.1 (2019-04-30)
+
+Fixes:
+
+- Correctly produce the user manual for [CTAN](https://ctan.org/).
+- Complete the support for named HTML entities (closes issue #36).
+
+Documentation:
+
+- Document the precise behavior of the `preserveTabs` Lua option (closes issue
+ #38).
+- Acknowledge [Lian Tze Lim](http://liantze.penguinattack.org/) and
+ [Overleaf](https://www.overleaf.com/) in the README.
+- Link TUGboat journal articles from the README.
+- Link the Markdown package installation from the README.
+
+Miscellanea:
+
+- Upgrade continuous integration from TeX Live 2019 pretest to TeX Live 2019.
+
+## 2.8.0 (2019-04-27)
+
+Development:
+
+- Added the `pipeTables` Lua option that enables [the PHP Markdown table syntax
+ extension](https://michelf.ca/projects/php-markdown/extra/#table), the
+ `tableCaptions` Lua option that enables [the Pandoc `table_captions` syntax
+ extension](https://pandoc.org/MANUAL.html#extension-table_captions), and the
+ `table` token renderer. Thanks to [David Vins](https://github.com/dvins) and
+ [Omedym](https://www.omedym.com) for sponsoring the development of table
+ support.
+- Added the `shiftHeadings` Lua option for shifting section levels, which
+ extends the *content slicing* capabilities of the Markdown package. Thanks to
+ [David Vins](https://github.com/dvins) and [Omedym](https://www.omedym.com)
+ for sponsoring the development of content slicing.
+
+Documentation:
+
+- Update README links to Markdown examples and tutorials by [Lian Tze
+ Lim](http://liantze.penguinattack.org/) and
+ [Overleaf](https://www.overleaf.com/).
+
+Fixes:
+
+- Remove an unreachable branch of the `parsers.line` parser.
+
+## 2.7.0 (2019-04-05)
+
+Development:
+
+- Added Natbib citation renderer to LaTeX.
+- Added the `slice` Lua option for *content slicing* – typesetting only certain
+ parts of a markdown document.
+ Thanks to [David Vins](https://github.com/dvins) and
+ [Omedym](https://www.omedym.com) for sponsoring the development of
+ content slicing.
+
+Fixes:
+
+- Stopped using the possibly active ASCII double quote characters (`"`) after
+ the `\input` TeX command.
+- Added space before the second parameter in the basic LaTeX citation renderer.
+- Fixed the `outputDir` Lua option, which enables the use of the
+ `-output-directory` TeX option.
+- Added support for Lua 5.3, which has been part of LuaTeX since 1.08.
+- Fixed the non-terminating LaTeX citation renderers for BibTeX and Natbib.
+- Fixed the capability of the unit testing script to add expected outcome to
+ unfinished testfiles.
+
+Documentation:
+
+- Finished the user manual.
+- Removed spurious commas in the documentation.
+- Used CTAN-compatible markdown markup in the README.
+
+Miscellaneous:
+
+- Made the unit testing script write Lua stack trace to the terminal when a
+ test fails.
+
+## 2.6.0 (2018-04-09)
+
+*Except for some minor changes in the README document, this version is
+identical to version 2.5.6. The author realized that they had forgotten to
+increase the minor version number despite adding a significant amount of new
+functionality.*
+
+## 2.5.6 (2018-04-08)
+
+Development:
+
+- Added a Lua command-line interface.
+- Added the `stripPercentSign` Lua option for using markdown in TeX package
+ documentation.
+
+Fixes:
+
+- Fixed TeX Live 2013 minted package detection.
+- Fixed the default LaTeX hyperlink renderer prototype to correctly typeset
+ hash signs.
+- Fixed lonely level four and five headings not being rendered in LaTeX.
+- Removed the no-op `outputDir` Lua option.
+
+Documentation:
+
+- Added a user manual.
+- Added information for contributors to the README document.
+- Increased portability of the technical documentation by using a built-in
+ BibLaTeX style.
+- Rewrote the technical documentation in markdown using the new
+ `stripPercentSign` Lua option.
+
+Miscellaneous:
+
+- Tuned the continuous integration service configuration, so that tests run
+ under 15 minutes.
+
+## 2.5.5 (2018-01-08)
+
+Documentation:
+
+- Fixed a typo in section 2.2.1.
+- Documented that the `contentBlocksCode` renderer receives five arguments.
+- Updated information in the documentation bibliography.
+- Incremented the year in copyright notices.
+
+## 2.5.4 (2017-09-12)
+
+Fixes:
+
+- `\markdownInfo` writes only to the log in the plain TeX implementation.
+- `\markdownInfo` and `\markdownWarning` start a new line in the plain TeX
+ implementation.
+- Lua errors are now caught even with shell escape.
+
+Development:
+
+- Added an `outputDir` option that enables the use of the TeX
+ `-output-directory` option.
+
+## 2.5.3 (2017-05-07)
+
+Fixes:
+
+- Added a missing file `examples/scientists.csv` to the CTAN archive.
+
+Documentation:
+
+- Added examples into the TDS archive.
+- Replaced tux in the examples with a generic example image.
+
+Development:
+
+- Updated the code for initializing testfiles.
+
+## 2.5.2 (2017-04-28)
+
+Fixes:
+
+- Added proper support for trailing internal punctuation in citations.
+
+## 2.5.1 (2017-04-27)
+
+Fixes:
+
+- Tab-indented fenced code is now supported.
+- Added missing underscore to `parsers.internal_punctuation`.
+- Removed unnecessary internal punctuation escaping (`$&~`) in citations.
+
+Documentation:
+
+- Corrected typo in bibliography.
+
+## 2.5.0 (2017-04-10)
+
+New features:
+
+- Added the `codeSpans` and `underscores` options.
+
+Documentation:
+
+- Reordered options alphabetically.
+
+## 2.4.0 (2017-03-27)
+
+Fixes:
+
+- Fixed the number of arguments in the `\markdownError` dummy definition.
+
+New features:
+
+- Added [the iA Writer content blocks syntax
+ extension](https://github.com/Witiko/markdown/issues/4).
+
+Documentation:
+
+- Fixed errors in the Lua interface documentation.
+- Fixed a typo in the `tests/templates` directory documentation.
+
+Development:
+
+- Added parallelized unit testing.
+
+## 2.3.0 (2017-01-05)
+
+Fixes:
+
+- ConTeXt module no longer mishandles active characters from `\enableregime`.
+- Shell access is no longer necessary with ConTeXt MarkIV.
+- The default renderers now render strong emphasis using a bold font face
+ rather than a bold-italic font face.
+- Lazy blockquotes are now parsed properly.
+
+New features:
+
+- Added optional HTML support; when the support is enabled, the Markdown reader
+ will recognize HTML elements, entities, instructions, and comments in the
+ input.
+- Added optional breakable blockquotes support; when the support is enabled,
+ blockquotes can be split apart using blank lines.
+
+Documentation:
+
+- Documented the behavior of the `-output-directory` TeX option.
+
+Development:
+
+- Removed unnecessary PEG patterns.
+- PEG patterns are now hash table entries rather than local variables; this was
+ a necessary step due to the local variable number limit. This change was also
+ backported to and merged by the
+ [upstream project](https://github.com/jgm/lunamark).
+- The unit test templates now use M4 instead of ad-hoc sed string replacement.
+- The Lua text buffering routine was removed as it only introduced complexity
+ to the package with no tangible benefits. All text buffering is now done in
+ TeX. As a corrolary, the `\markdownLuaRegisterIBCallback` and
+ `\markdownLuaUnregisterIBCallback` macros have been deprecated.
+
+## 2.2.2 (2016-12-09)
+
+Fixes:
+
+- Inline footnotes can now be enabled via the LaTeX interface.
+
+Development:
+
+- Added inline footnotes to the example documents.
+
+## 2.2.1 (2016-12-07)
+
+New features:
+
+- Added Pandoc-style inline footnotes.
+
+## 2.1.3 (2016-09-15)
+
+Fixes:
+
+- LaTeX implementation doesn't load `paralist` in `beamer` unless requested.
+
+## 2.1.2 (2016-09-14)
+
+Fixes:
+
+- Unordered list items now may begin with a `bulletchar`.
+
+Documentation:
+
+- Expanded the documentation on `hashEnumerators`.
+
+## 2.1.1 (2016-09-06)
+
+Fixes:
+
+- The citations extension should now be fully compliant with the
+ [Pandoc spec](http://pandoc.org/MANUAL.html#citations).
+- The `citationNbsps` option now also affects newlines, as is expected.
+- The default `\markdownOptionCacheDir` explicitly specifies the current
+ working directory, so that the cache files are not sought in the TeX
+ directory structure.
+
+Documentation:
+
+- Added information about the supported LuaTeX versions.
+- Added information about the portable use of the package.
+
+Development:
+
+- All the syntax extensions (fenced code blocks and citations) were merged by
+ the [upstream project](http://github.com/jgm/lunamark).
+
+## 2.1.0 (2016-08-29)
+
+New features:
+
+- Added Pandoc-style citations and CommonMark fenced code blocks syntax
+ extensions.
+- Added the following renderers:
+ - `interblockSeparator`,
+ - `ulItemEnd`, `olItemEnd`, `dlItemEnd`,
+ - `nbsp`, `cite`, `textCite`, and
+ - `inputFencedCode`.
+- Added the following Lua options:
+ - `citations`, `citationNbsps`,
+ - `fencedCode`, and `blankBeforeCodeFence`.
+
+Changes in behavior:
+
+- Replaced the `-` character in the default `\markdownOptionCacheDir` with `_`.
+- The cache filenames are now different based on the version of the package.
+- Code spans may now be empty.
+
+Fixes:
+
+- The conversion from Markdown should now produce consistent behavior no matter
+ if the input of the conversion function ends with `\n\n`, `\n`, or nothing.
+- LaTeX interface `rendererPrototypes` keys for the `pipe`, `link`, and `image`
+ renderers no longer incorrectly set the `\markdownRenderers<Renderer>` macros
+ rather than the `\markdownRenderers<Renderer>Prototype` macros.
+
+## 2.0.2 (2016-08-17)
+
+Fixes:
+
+- Fixed nested `keyval` handling inside `\markdownSetup` et al.
+
+## 2.0.1 (2016-08-15)
+
+Fixes:
+
+- Make the programming more defensive, so that the package works correctly
+ under TeXLive 2012.
+
+Development:
+
+- Added the package to a continuous integration service.
+
+## 2.0.0 (2016-08-15)
+
+New features:
+
+- Added raw unescaped URI to the `link` and `image` renderer arguments.
+ (This breaks backwards compatibility, hence the major version number bump.)
+- Added renderers for plain TeX and ConteXt special characters.
+
+Fixes:
+
+- Make autolinks work by preventing `Str` from consuming `<`.
+- Non-found footnote ref no longer outputs unescaped text.
+- Catcode of `|` is now other in `\markdownReadAndConvert` for ConTeXt.
+- Restore escapability of `<`, `>` to enable escaping of autolinks.
+
+Development:
+
+- Added a suite of tests.
+
+## 1.0.1 (2016-06-06)
+
+New features:
+
+- Added the `tightLists` Lua interface option.
+
+## 1.0.0 (2016-06-04)
+
+The first release.