top | item 46019066

(no title)

henrebotha | 3 months ago

There are real limitations to this: You can't arbitrarily mix and match HTML and Markdown. As soon as you introduce an HTML block, you're locked out of Markdown syntax.

AsciiDoc lets you mix and match however you want. Or, put differently: AsciiDoc's superiority over Markdown extends even to being better at shelling out to HTML.

discuss

order

vidarh|3 months ago

While that's true, I'd take Markdown + extensions to allow inline HTML or custom tags over AsciiDoc any day, even at the cost of losing some compatibility - converting that to plain Markdown is usually easy enough.

judahmeek|3 months ago

What are the trade-offs with AsciiDoc that would make you choose Markdown instead?

youngtaff|3 months ago

O’Reilly’s authoring system used to use AsciiDoc (may still do), made me hate AsciiDoc

tefkah|3 months ago

mdx does tho. you could just not define any components, then you can nest markdown inside html no problem