diff --git a/.markdownlint.json b/.markdownlint.json
new file mode 100644
index 0000000..e095433
--- /dev/null
+++ b/.markdownlint.json
@@ -0,0 +1,19 @@
+{
+  "line-length": false,
+  "MD007": {
+    "indent": 4
+  },
+  "MD033": {
+    "allowed_elements": [ "div", "s", "span", "u", "p" ]
+  },
+  "blanks-around-headings":{
+    "lines_above": 2,
+    "lines_below": 1
+  },
+  "MD012": { 
+    "maximum": 2
+  }, 
+  "comment": {
+    "MD012": "MD012 max=2 added so that headings can have two lines above for clarity."
+  }
+}