Site Extensions

    March 9, 2025
    + 12

    Test and document your Asciidoctor.js or Antora extensions here.

    Markdown Block

    asciidoc
    [markdown] -- Filter some text with [Markdown](https://commonmark.org/help/) syntax. --

    Results in:

    Filter some text with Markdown syntax.

    This is not implemented with a full Markdown parser. See issue with a link to the "naive series of regexes" used as starting point.

    (And note that we use Open structural context, with -- delimiters, and headings don’t work inside these.)

    This feature is intended for handling OpenAPI specs, which can contain Markdown, however openapi-generator has poor Asciidoc handling, so instead we add the block delimiters in the template, and let the block filter handle it.