diff --git a/.markdown-lint.yml b/.markdown-lint.yml
new file mode 100644
index 0000000..f177033
--- /dev/null
+++ b/.markdown-lint.yml
@@ -0,0 +1,12 @@
+MD003: false
+MD004:
+  style: dash
+MD013:
+  tables: false
+MD026: false
+MD029:
+  style: one
+MD033: false
+MD034: false
+MD036: false
+MD041: false
diff --git a/.mega-linter.yml b/.mega-linter.yml
index 4c93029..18fd2cd 100644
--- a/.mega-linter.yml
+++ b/.mega-linter.yml
@@ -20,6 +20,7 @@ DISABLE:
 # https://megalinter.io/latest/config-activation/
 DISABLE_LINTERS:
   - MARKDOWN_MARKDOWN_TABLE_FORMATTER
+  - REPOSITORY_GRYPE
   - REPOSITORY_KICS
   - REPOSITORY_TRIVY
   - TYPESCRIPT_STANDARD
@@ -137,7 +138,7 @@ VALIDATE_ALL_CODEBASE: true
 JAVASCRIPT_ES_CONFIG_FILE: .eslintrc.yml
 JAVASCRIPT_PRETTIER_CONFIG_FILE: prettierrc.yml
 JSON_PRETTIER_CONFIG_FILE: prettierrc.yml
-MARKDOWN_MARKDOWNLINT_CONFIG_FILE: .markdownlint.yml
+MARKDOWN_MARKDOWNLINT_CONFIG_FILE: .markdown-lint.yml
 TYPESCRIPT_ES_CONFIG_FILE: .eslintrc.yml
 TYPESCRIPT_PRETTIER_CONFIG_FILE: .prettierrc.yml
 YAML_PRETTIER_CONFIG_FILE: .prettierrc.yml
diff --git a/README.md b/README.md
index eece0d2..430c41e 100644
--- a/README.md
+++ b/README.md
@@ -133,6 +133,8 @@ IssueOps-Demo-Writers-NotATeam
 
 The output of this action would be:
 
+<!-- markdownlint-disable -->
+
 ```json
 {
   "name": "this-thing",
@@ -158,6 +160,8 @@ The output of this action would be:
 }
 ```
 
+<!-- markdownlint-enable -->
+
 ### No Template Provided
 
 The `issue-form-template` input is optional. If not provided, the action will
@@ -167,6 +171,8 @@ the contents of the headers.
 
 Using the same example as above, the output would instead be:
 
+<!-- markdownlint-disable -->
+
 ```json
 {
   "the_name_of_the_thing": "this-thing",
@@ -186,6 +192,8 @@ Using the same example as above, the output would instead be:
 }
 ```
 
+<!-- markdownlint-enable -->
+
 ## Transformations
 
 ### Headings