diff --git a/README.md b/README.md
index 08684d3b..4d791415 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,12 @@ Marked is
 3. light-weight while implementing all markdown features from the supported flavors & specifications.
 4. available as a command line interface (CLI) and running in client- or server-side JavaScript projects.
 
+## Demo
+
+Checkout the [demo page](https://marked.js.org/demo.html) to see marked in action ⛹️
+
+Our [documentation pages](https://marked.js.org) are also rendered using marked 💯
+
 ## Installation
 
 **CLI:** `npm install -g marked`
@@ -45,8 +51,6 @@ $ cat hello.html
 </html>
 ```
 
-
-
 ## License
 
 Copyright (c) 2011-2018, Christopher Jeffrey. (MIT License)
diff --git a/docs/README.md b/docs/README.md
index e0bfea8e..166dcd7e 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,5 +1,6 @@
 <ul>
   <li><a href="#marked">About</a></li>
+  <li><a href="#demo">Demo</a></li>
   <li><a href="#installation">Installation</a></li>
   <li><a href="#usage">Usage</a></li>
   <li><a href="#specifications">Supported Markdown specifications</a></li>
@@ -22,6 +23,14 @@ Marked is
 <small><sup>**</sup> As few dependencies as possible.</small><br>
 <small><sup>***</sup> Strict compliance could result in slower processing when running comparative benchmarking.</small></p>
 
+
+<h2 id="demo">Demo</h2>
+
+Checkout the [demo page](https://marked.js.org/demo.html) to see marked in action ⛹️
+
+These documentation pages are also rendered using marked 💯
+
+
 <h2 id="installation">Installation</h2>
 
 **CLI:** `npm install -g marked`