Current mix of Markdown and HTML in content files causes issues in some MD parsers

[rcherny]

For instance, some Markdown parsers are choking on it, particularly the "box" asides.

By in large, it works, just could be better.