refactor: integrate markdownlint with pyproject.toml

Author: dingo4dev

.markdownlint.yaml

@@ -7,11 +7,18 @@ repos:
       - id: prettier
         types_or: [yaml, json5]
 
-  - repo: https://github.com/DavidAnson/markdownlint-cli2
-    rev: v0.18.1
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.45.0
     hooks:
-      - id: markdownlint-cli2
-        args: ["--fix"]
+      - id: markdownlint
+        args:
+          [
+            "--fix",
+            "--config",
+            "pyproject.toml",
+            "--configPointer",
+            "/tool/markdown/lint",
+          ]
         types: [markdown]
 
   - repo: local

.pre-commit-config.yaml

@@ -45,6 +45,7 @@ uv run ruff format .
 ```
 
 7. Update README snippets if you modified example code:
+
 ```bash
 uv run scripts/update_readme_snippets.py
 ```

CONTRIBUTING.md

@@ -235,6 +235,7 @@ def get_settings() -> str:
   "debug": false
 }"""
 ```
+
 _Full example: [examples/snippets/servers/basic_resource.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/servers/basic_resource.py)_
 <!-- /snippet-source -->
 
@@ -261,6 +262,7 @@ def get_weather(city: str, unit: str = "celsius") -> str:
     # This would normally call a weather API
     return f"Weather in {city}: 22degrees{unit[0].upper()}"
 ```
+
 _Full example: [examples/snippets/servers/basic_tool.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/servers/basic_tool.py)_
 <!-- /snippet-source -->
 
@@ -411,6 +413,7 @@ def debug_error(error: str) -> list[base.Message]:
         base.AssistantMessage("I'll help debug that. What have you tried so far?"),
     ]
 ```
+
 _Full example: [examples/snippets/servers/basic_prompt.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/servers/basic_prompt.py)_
 <!-- /snippet-source -->
 
@@ -460,6 +463,7 @@ async def long_running_task(task_name: str, ctx: Context, steps: int = 5) -> str
 
     return f"Task '{task_name}' completed"
 ```
+
 _Full example: [examples/snippets/servers/tool_progress.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/servers/tool_progress.py)_
 <!-- /snippet-source -->
 
@@ -547,6 +551,7 @@ async def handle_completion(
 
     return None
 ```
+
 _Full example: [examples/snippets/servers/completion.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/servers/completion.py)_
 <!-- /snippet-source -->
 ### Elicitation
@@ -597,6 +602,7 @@ async def book_table(
     # Date available
     return f"[SUCCESS] Booked for {date} at {time}"
 ```
+
 _Full example: [examples/snippets/servers/elicitation.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/servers/elicitation.py)_
 <!-- /snippet-source -->
 
@@ -637,6 +643,7 @@ async def generate_poem(topic: str, ctx: Context) -> str:
         return result.content.text
     return str(result.content)
 ```
+
 _Full example: [examples/snippets/servers/sampling.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/servers/sampling.py)_
 <!-- /snippet-source -->
 
@@ -665,6 +672,7 @@ async def process_data(data: str, ctx: Context) -> str:
 
     return f"Processed: {data}"
 ```
+
 _Full example: [examples/snippets/servers/notifications.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/servers/notifications.py)_
 <!-- /snippet-source -->
 

README.md

@@ -129,3 +129,27 @@ filterwarnings = [
     # pywin32 internal deprecation warning
     "ignore:getargs.*The 'u' format is deprecated:DeprecationWarning"
 ]
+
+[tool.markdown.lint]
+default=true
+
+# MD004 ul-style - Unordered list style
+MD004=false
+
+# MD007 ul-indent - Unordered list indentation
+MD007.indent=2
+
+# MD013 line-length - Line length
+MD013=false
+
+# MD029 ol-prefix - Ordered list item prefix
+MD029=false
+
+# MD033 no-inline-html Inline HTML
+MD033=false
+
+# MD041 first-line-heading/first-line-h1
+MD041=false
+
+# MD059 descriptive-link-text
+MD059=false