Adding Markdown to Ddoc

[Walter Bright]

On 12/9/2017 1:05 PM, David Gileadi wrote:
> On 12/8/17 6:49 PM, Walter Bright wrote:
>> On 12/8/2017 7:30 AM, Jacob Carlborg wrote:
>>> Otherwise it will be confusing and very hard to remember which features are 
>>> supported with Markdown syntax and which are not.
>>
>> This is way overstating the case. Ddoc already supports some markdown, and 
>> some markdown in different ways.
> 
> For instance, as I've been working on adding Markdown features I was surprised 
> to discover that DDoc's current support for backtick-delimited code only works 
> within a single line. Most implementations I've seen allow it to span 
> hard-wrapped lines, as long as it's within a single paragraph.

The:

---
code
---

is for multiline code blocks.


> I'd like to support as many Markdown features as we can,

Only the ones that make good sense for Ddoc, not as many as technically possible.


> but there will always 
> be a some differences--particularly those that conflict with existing DDoc 
> features.

Yes, and keep in mind there is no such thing as standard Markdown. Every 
implementation has significant differences.