Worst Phobos documentation evar!

[Ary Borenszweig via Digitalmars-d]

On 12/31/14 4:14 PM, Walter Bright wrote:
> On 12/31/2014 6:29 AM, Jacob Carlborg wrote:
>> On 2014-12-30 01:10, Walter Bright wrote:
>>
>>> It's not a hack. The macro system is designed to work that way. All
>>> markup systems require some sort of escape mechanism. Including Markup.
>>
>> You don't need to escape all the special symbols used in Markdown,
>> only in
>> certain place. In Markdown, if you start a line with a star, '*', it
>> will be
>> interpreted as the beginning of an unordered list. But if you write a
>> star in
>> the middle of text it will just output a star, as expected.
>
> I know that Markdown formatting is context sensitive.
>
> And what happens if you want to have a * at the beginning of the line of
> output? And a | in a table entry? And so on for each of the context
> sensitive things?

You use a backslash character, like in almost every programming 
language, json, etc.

http://daringfireball.net/projects/markdown/syntax#backslash

Compare \* to $(STAR)