diff --git a/.gitignore b/.gitignore
index 67f0dc51..cf81ad04 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,6 +6,8 @@ lexer/*.php
 lexer/*.php.bak
 lexer/*.out
 
+/site
+
 # Dev
 phpunit*
 .phpunit.result.cache
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 00000000..e1868e67
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,21 @@
+site_name: Smarty Documentation
+theme:
+  name: material
+  palette:
+    primary: amber
+  features:
+    - content.code.copy
+  icon:
+    logo: material/lightbulb-on
+  favicon: images/favicon.ico
+
+extra:
+  version:
+    provider: mike
+
+markdown_extensions:
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences