docs using xml in code blocks will improperly render

[aaronmarkham]

As this has bitten me several times now, so I'm writing this up as an issue. It is likely a bug in recommonmark.

If you use entities that can be interpreted as tags, like

#Three opening backticks
'''
<dependency>
...

This will render improperly.

If you use

```xml
<dependency>
...

This will render improperly.

If you use

```html
<dependency>
...

This will render properly.

There may be other workarounds, but for now I'm using ```html
This has been coming up in documentation for scala.

[frankfliu]

Hi @aaronmarkham thanks for submitting the issue, @sandeep-krishnamurthy requesting this be labeled Doc

[ThomasDelteil]

@aaronmarkham is there further action required on this issue?

[aaronmarkham]

Actually there is. Something keeps mucking with the code and escaping it improperly.

[aaronmarkham]

@andrewfayres and @lanking520 - They said they might be able to help figure out what is going on with it.

[lanking520]

Basically it's a transition failure, such as the example below:
https://github.com/apache/incubator-mxnet/blob/master/docs/tutorials/scala/mxnet_scala_on_intellij.md

and

http://mxnet.incubator.apache.org/tutorials/scala/mxnet_scala_on_intellij.html

If you compare the dependencies in the markdown is showing correctly, however, in website is wrongly translated.

<dependency> Sample </dependency>

<dependency>Sample dependency>

</ seemed to have some issues.