diff --git a/docs/extensions.md b/docs/extensions.md
new file mode 100644
index 00000000..320cefa0
--- /dev/null
+++ b/docs/extensions.md
@@ -0,0 +1,36 @@
+Showdown allows you to load additional functionality via extensions. You can find a list of known Showdown extensions [here][ext-wiki].
+
+You can also check the [boilerplate repo][boilerplate-repo], to create your own extension(s).
+
+## Usage
+
+=== "Server-side"
+
+ ```js
+ // Using a bundled extension
+ var showdown = require('showdown');
+ var converter = new showdown.Converter({ extensions: ['twitter'] });
+
+ // Using a custom extension
+ var mine = require('./custom-extensions/mine');
+ var converter = new showdown.Converter({ extensions: ['twitter', mine] });
+ ```
+
+=== "Client-side"
+
+ ```js
+
+
+
+ ```
+
+=== "CLI"
+
+ In the CLI tool, use the [`-e` flag](/cli/#-e-extensions) to load an extension.
+
+ ```sh
+ showdown -e twitter -i foo.md -o bar.html
+ ```
+
+[ext-wiki]: https://github.com/showdownjs/showdown/wiki/extensions
+[boilerplate-repo]: https://github.com/showdownjs/extension-boilerplate
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index b87fdf09..a1d77cd7 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -38,4 +38,6 @@ nav:
- Available options: available-options.md
- Flavors: flavors.md
- CLI: cli.md
- - Integrations: integrations.md
\ No newline at end of file
+ - Integrations: integrations.md
+ - Extensions:
+ - Overview: extensions.md
\ No newline at end of file