diff --git a/slim.md b/slim.md
index 7df1ba919..953501e31 100644
--- a/slim.md
+++ b/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