Add pydantic-docs dev dependency

Author: Viicos

mkdocs.yml

@@ -286,6 +286,7 @@ markdown_extensions:
   - pymdownx.tasklist:
       custom_checkbox: true
   - sane_lists # this means you can start a list from any number
+  - pydantic_docs.mdext
 
 watch:
   - pydantic_ai_slim

pyproject.toml

@@ -75,6 +75,7 @@ pydantic-ai-slim = { workspace = true }
 pydantic-evals = { workspace = true }
 pydantic-graph = { workspace = true }
 pydantic-ai-examples = { workspace = true }
+pydantic-docs = { git = "https://github.com/pydantic/pydantic-docs" }
 
 [tool.uv.workspace]
 members = [
@@ -118,10 +119,11 @@ docs = [
     "mkdocs>=1.6.1",
     "mkdocs-glightbox>=0.4.0",
     "mkdocs-llmstxt>=0.2.0",
-    'mkdocs-redirects>=1.2.2',
+    "mkdocs-redirects>=1.2.2",
     "mkdocs-material[imaging]>=9.5.45",
     "mkdocstrings-python>=1.12.2",
     "griffe-warnings-deprecated>=1.1.0",
+    "pydantic-docs",
 ]
 docs-upload = ["algoliasearch>=4.12.0", "pydantic>=2.10.1"]