diff --git a/.gitignore b/.gitignore
index 618dbfd..d623135 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,6 +4,7 @@ dist/*
 chart/*
 *.yaml
 *.yml
+!.markdownlint.yaml
 !generator/*.yaml
 doc/venv/*
 !doc/mkdocs.yaml
diff --git a/.markdownlint.yaml b/.markdownlint.yaml
new file mode 100644
index 0000000..62408cb
--- /dev/null
+++ b/.markdownlint.yaml
@@ -0,0 +1,18 @@
+# markdownlint configuration file
+default: true
+
+MD013: # Line length
+  line_length: 240
+
+MD010: # Hard tabs
+  code_blocks: false
+
+# no inline HTML
+MD033: false
+
+# heading as first line element...
+MD041: false
+
+# list indentation
+MD007:
+  indent: 4