docs(lint): sync CI and local pre-commit

Author: heitorlessa

.pre-commit-config.yaml

@@ -4,30 +4,35 @@
 # All checks can be run locally via `make pr`
 
 repos:
-    - repo: https://github.com/pre-commit/pre-commit-hooks
-      rev: v2.4.0
-      hooks:
-          - id: check-merge-conflict
-          - id: trailing-whitespace
-          - id: end-of-file-fixer
-          - id: check-toml
-    - repo: local
-      hooks:
-          - id: black
-            name: formatting::black
-            entry: poetry run black
-            language: system
-            types: [python]
-          - id: isort
-            name: formatting::isort
-            entry: poetry run isort
-            language: system
-            types: [python]
-    - repo: local
-      hooks:
-          - id: flake8
-            name: linting::flake8
-            entry: poetry run flake8
-            language: system
-            types: [python]
-            exclude: example
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v2.4.0
+    hooks:
+      - id: check-merge-conflict
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-toml
+  - repo: local
+    hooks:
+      - id: black
+        name: formatting::black
+        entry: poetry run black
+        language: system
+        types: [python]
+      - id: isort
+        name: formatting::isort
+        entry: poetry run isort
+        language: system
+        types: [python]
+  - repo: local
+    hooks:
+      - id: flake8
+        name: linting::flake8
+        entry: poetry run flake8
+        language: system
+        types: [python]
+        exclude: example
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: "11c08644ce6df850480d98f628596446a526cbc6" # frozen: v0.31.1
+    hooks:
+      - id: markdownlint
+        args: ["--fix"]

Makefile

@@ -17,10 +17,10 @@ lint: format
 	poetry run flake8 aws_lambda_powertools/* tests/*
 
 lint-docs:
-	docker run -v ${PWD}:/markdown 06kellyjac/markdownlint-cli:0.28.1-alpine "docs"
+	docker run -v ${PWD}:/markdown 06kellyjac/markdownlint-cli "docs"
 
 lint-docs-fix:
-	docker run -v ${PWD}:/markdown 06kellyjac/markdownlint-cli:0.28.1-alpine --fix "docs"
+	docker run -v ${PWD}:/markdown 06kellyjac/markdownlint-cli --fix "docs"
 
 test:
 	poetry run pytest -m "not perf" --cov=aws_lambda_powertools --cov-report=xml