This is a patch release in the 2.0.x release line to fix bugs and make a few minor improvements.
Attribute references in the attrlist of the toc macro are now resolved, as documented. If the stem macro uses invalid substitutions, the warning message will cite the stem macro rather than the passthrough macro. When converting to DocBook, the quoted text is no longer used to set the xreflabel as this leads to invalid XML.
The HTML now loads the MathJax configuration to support stem integration as recommended by MathJax itself (https://docs.mathjax.org/en/latest/output/html.html#html-support). In the manpage output, a thin space is used in between the dots of an ellipsis to distinguish it from three consecutive dots by making it wider.
Distribution
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.
Changelog
Improvement
- Use MathJax config recommended by MathJax itself; see https://docs.mathjax.org/en/latest/output/html.html#html-support (#4424)
- Use thin space between dots of an ellipsis (U+2026) in manpage output (#4568)
Bug Fixes
- Don't use text of span as value of xreflabel when node has ID in DocBook output (#4539)
- Resolve attribute references (attributes substitution) in attrlist of toc macro (#4806)
- Cite stem macro specifically in warning message when macro has invalid substitutions (#4808)
Release meta
Released on: 2025-10-23
Released by: @mojavelinux
Release beer: Oktoberfest by Athletic Brewing
Logs: resolved issues | source diff | gem diff
Credits
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.