Merge PR #433

* pr/433:
  Slim: update markdown section
  Added section explaining Markdown support

slim.md

@@ -60,6 +60,19 @@ ruby:
 div= foobar
 ```
 
+### Inline Markdown
+
+```jade
+markdown:
+  ### On Markdown
+
+  I am *Markdown* _text_!
+  {: .classname}
+```
+
+Slim can handle your [Markdown](https://daringfireball.net/projects/markdown/syntax) content for longer content blocks or `code`.
+Depending on your parser, like [Kramdown](https://kramdown.gettalong.org/quickref.html), other features might work, like assigning attributes or classes.
+
 ### Embedded JavaScript
 
 ```jade
@@ -67,6 +80,7 @@ javascript:
   alert('Slim supports embedded javascript!')
 ```
 
+
 ### Comments
 
 ```jade