diff --git a/docs/index.md b/docs/index.md
index ee359f4..ed62cb0 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,3 +1 @@
-# Welcome!
-
-MEDS-Transforms is a library. More details incoming.
+--8\<-- "README.md"
diff --git a/pipeline_configuration.md b/docs/pipeline_configuration.md
similarity index 100%
rename from pipeline_configuration.md
rename to docs/pipeline_configuration.md
diff --git a/preprocessing_operation_prototypes.md b/docs/preprocessing_operation_prototypes.md
similarity index 100%
rename from preprocessing_operation_prototypes.md
rename to docs/preprocessing_operation_prototypes.md
diff --git a/terminology.md b/docs/terminology.md
similarity index 100%
rename from terminology.md
rename to docs/terminology.md
diff --git a/mkdocs.yml b/mkdocs.yml
index a49156d..02bd3d6 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -5,6 +5,9 @@ site_author: Matthew McDermott
 
 nav:
   - Home: index.md
+  - "Pipeline Configuration": pipeline_configuration.md
+  - "Pre-processing Operations": preprocessing_operation_prototypes.md
+  - "Terminology": terminology.md
   - API: api/
   - Issues: https://github.com/mmcdermott/MEDS_transforms/issues
 
@@ -14,8 +17,16 @@ theme:
 
 markdown_extensions:
   - smarty
-    #  - pymdownx.arithmatex:
-    #      generic: true
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.inlinehilite
+  - pymdownx.smartsymbols
+  - pymdownx.snippets
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.superfences
 
 extra_javascript:
   - javascripts/mathjax.js