Asciidoctor :: Discussion - Re: Another markup-escaping question

Re: Another markup-escaping question

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

The only line of content that needs to be escaped inside a delimited block is a line that matches the start delimiter exactly. When that situation occurs, you can simply vary the length of the enclosing delimiter lines to prevent the match.

Having said that, I don't see any reason why your example wouldn't work. A line that consists of two hyphens inside of a listing block does not have any special meaning.

Are you observing unexpected output? If so, using which tool and version?

-Dan

On Sun, Jun 18, 2017 at 5:07 PM, oddhack [via Asciidoctor :: Discussion] <[hidden email]> wrote:

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

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?

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Another-markup-escaping-question-tp5665.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Dan Allen | @mojavelinux | https://twitter.com/mojavelinux