Posted by oddhack on
URL: https://discuss.asciidoctor.org/Another-markup-escaping-question-tp5665.html

I'm writing some source blocks containing asciidoc content, as part of our style guide. I'd like to get
something like this:

[NOTE]
.Guideline
====
To introduce the description, start an open block:

[source,asciidoc]
----
[open,refpage='command']
--
Command description
----
====

With the intent to result in output like (leading spaces added just for reading purposes):

    Guideline
    To introduce the description, start an open block:

    [open,refpage='command']
    --
    Command description

But I can't figure out how to escape the '--' markup to make its way through to the source highlighter, without the escape marks also making their way through. I've played a bit with different block delimiters, uselessly. Any thoughts on how to do this?