A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML5, DocBook 5 (or 4.5) and other formats.

Critical or Security advisories for

This version doesn't have any advisory. Want to report one?

Changelog for


Bug fixes
  • continue to read blocks inside a delimited block after content is skipped (PR #2318)

  • don't create an empty paragraph for skipped content inside a delimited block (PR #2319)

  • allow the subs argument of Substitutors#apply_subs to be nil

  • coerce group name to symbol when registering extension (#2324)

  • eagerly substitute attributes in target of inline image macro (#2330)

  • don't warn if source stylesheet can't be read but destination already exists (#2323)

  • track include path correctly if path is absolute and outside of base directory (#2107)

  • preprocess second line of setext section title (PR #2321)

  • preprocess second line of setext discrete heading (PR #2332)

  • return filename as relative path if filename doesn't share common root with base directory (#2107)

Improvements / Refactoring
  • change default text for inter-document xref (PR #2316)

  • add additional tests to test behavior of Reader#peek_lines

  • parse revision info line correctly that only has version and remark; add missing test for scenario

  • rename AtxSectionRx constant to AtxSectionTitleRx for consistency with SetextSectionTitleRx constant

  • use terms “atx” and “setext” to refer to section title syntax (PR #2334)

  • rename HybridLayoutBreakRx constant to ExtLayoutBreakRx

  • change terminology from “floating title” to “discrete heading”

  • consolidate skip blank lines and check for end of reader (PR #2325)

  • have Reader#skip_blank_lines report end of file (PR #2325)

  • don't mix return type of Parser.build_block method (PR #2328)

  • don't track eof state in reader (PR #2320)

  • use shift instead of advance to consume line when return value isn't needed (PR #2322)

  • replace terminology “floating title” with “discrete heading”

  • remove unnecessary nil_or_empty? checks in substitutor

  • leverage built-in assert / refute methods in test suite

Build / Infrastructure
  • config Travis CI job to release gem (PR #2333)

  • add SHA1 hash to message used for triggered builds

  • trigger build of AsciidoctorJ on every change to core

  • trigger build of Asciidoctor Diagram on every change to core

Distribution Packages[issues resolved] |[git tag] |…v1.5.6.1[full diff] // end::compact[]

Dependencies for

Name Requirement Status
This version doesn't have runtime dependencies.

My projects using asciidoctor

Name Locked version Requirement
You should be logged in to see which of your projects use asciidoctor.