diff --git a/docs/README.md b/README.md
similarity index 100%
rename from docs/README.md
rename to README.md
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..537ddb9
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,3 @@
+--8<--
+README.md
+--8<--
diff --git a/mkdocs.yml b/mkdocs.yml
index 394a769..4eca163 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -18,6 +18,8 @@ theme:
     - navigation.sections
     - search.highlight
 markdown_extensions:
+  - pymdownx.snippets:
+      check_paths: true
   - pymdownx.superfences:
       custom_fences:
         - name: mermaid