[GitHub] aaronmarkham opened a new issue #11438: docs using xml in code blocks will improperly render

[GitBox <gi...@apache.org>]

aaronmarkham opened a new issue #11438: docs using xml in code blocks will improperly render
URL: https://github.com/apache/incubator-mxnet/issues/11438
 
 
   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.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services