diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 4edcbb5..dffeb02 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -18,7 +18,7 @@ repos:
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
     # Ruff version.
-    rev: v0.5.5
+    rev: v0.6.1
     hooks:
       # Run the linter.
       - id: ruff
@@ -50,7 +50,7 @@ repos:
           ]
 
   - repo: https://github.com/fpgmaas/deptry.git
-    rev: "0.18.0"
+    rev: "0.19.1"
     hooks:
       - id: deptry
 
@@ -64,7 +64,7 @@ repos:
           - --allow-breaking
 
   - repo: https://github.com/hfudev/rstfmt
-    rev: v0.1.3
+    rev: v0.1.4
     hooks:
       - id: rstfmt
         args: ["-w", "-1"]
@@ -73,3 +73,21 @@ repos:
           "sphinx_tabs",
           "sphinx-click",
         ]
+
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.17
+    hooks:
+      - id: mdformat
+        args: [--number] # Keep numbering for ordered lists
+        additional_dependencies:
+          - mdformat-gfm # Support for GitHub Flavored Markdown (GFM), including tables, task lists, strikethroughs, and autolinks.
+          - mdformat-ruff # Formats Python code blocks in Markdown files according to the `ruff` linter's style.
+          - mdformat-simple-breaks # Ensures that single line breaks in Markdown are converted to `<br>`
+
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets
+        args:
+          - --base64-limit=5 # Level of entropy for base64 type strings
+          - --hex-limit=3 # Level of entropy for hex strings
diff --git a/README.md b/README.md
index a75fe00..d9ffae5 100644
--- a/README.md
+++ b/README.md
@@ -109,6 +109,7 @@ For that, add `examples` field to the root of the manifest:
 examples:
   - path: ../some/path
   - path: ../some/other_path
+  # - path: examples/some_example # this example will be discovered automatically
 ```
 
 ## Environment variables