github asciidoctor/asciidoctor v2.0.15


Right on the tails of the previous release, this minor patch release comes out of thoroughly testing the Asciidoctor 1 to Asciidoctor 2 upgrade on several large documentation sites. That hope that the previous release was the last one in the 2.0.x series before work begins on 2.1.x now extends to this release.

The main issue this release fixes is to provide fallback xreftext for HTML output and the correct linkend value for DocBook output when an xref resolves to the current document and no link text is provided. This release also brings three minor fixes to how attrlists are parsed, though the impact of these changes is likely very small. While working on parsing, we discovered that trailing punctuation (., ?, and !) was getting included in the target URL of an autolink in certain cases. The trailing punctuation now stays outside of the link. In the manpage output, keyboard references are now formatted in monospace. Additionally, text formatting markup should now be interpreted more accurately.

Consult the CHANGELOG to find the full list of changes in this release.


Asciidoctor is also packaged for Fedora, Debian, Ubuntu, Alpine Linux, OpenSUSE, and Homebrew. You can use the system's package manager to install the package named asciidoctor.

Release meta

Released on: 2020-04-27
Released by: @mojavelinux
Release beer: Casey, You're On Mute by 4 Noses Brewing Company

Logs: resolved issues | full diff | issues resolved in 2.0.x (cumulative)


Bug Fixes

  • Don't include trailing period, question mark, or exclamation point in target (URL) of autolink (#3860)
  • Don't assign nil value to named attribute mapped to absent positional attribute when parsing attrlist (#4033)
  • Remove leading and trailing spaces around role on inline phrase (#4035)
  • Ignore empty role on inline phrase defined using legacy syntax and followed by comma (#4035)
  • Use xreftext on document as fallback link text in HTML output for inter-document xref that resolves to current document when no link text is provided (#4032)
  • Use xreftext on document as fallback link text in HTML output for internal xref with empty fragment when no link text is provided (#4032)
  • Use document ID as linkend in DocBook output for internal xref with empty fragment; auto-generating one if necessary (#4032)


  • Format keyboard references in monospace in manpage output

Build / Infrastructure

  • Get remaining invoker tests working on JRuby 9.1 for Windows


A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign who provided critical funding for the development of this release as well as ongoing development of the project. We'd also like to thank the maintainers of the Rouge project, who helped us work through the compatibility issue with Rouge and applied a fix to restore it ahead of our own release.

latest release: v2.0.16
4 months ago