diff --git a/mkdocs.yml b/mkdocs.yml
index 5f827ae71b..e61bdbf007 100644
--- a/mkdocs.yml
+++ b/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
diff --git a/pyproject.toml b/pyproject.toml
index 3c13afdece..740a07e361 100644
--- a/pyproject.toml
+++ b/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"]
 
diff --git a/uv.lock b/uv.lock
index a3738b262b..df390d6e24 100644
--- a/uv.lock
+++ b/uv.lock
@@ -5432,6 +5432,7 @@ docs = [
     { name = "mkdocs-redirects" },
     { name = "mkdocstrings-python" },
     { name = "pydantic-ai", extra = ["a2a"] },
+    { name = "pydantic-docs" },
 ]
 docs-upload = [
     { name = "algoliasearch" },
@@ -5490,6 +5491,7 @@ docs = [
     { name = "mkdocs-redirects", specifier = ">=1.2.2" },
     { name = "mkdocstrings-python", specifier = ">=1.12.2" },
     { name = "pydantic-ai", extras = ["a2a"], editable = "." },
+    { name = "pydantic-docs", git = "https://github.com/pydantic/pydantic-docs" },
 ]
 docs-upload = [
     { name = "algoliasearch", specifier = ">=4.12.0" },
@@ -5795,6 +5797,19 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/32/56/8a7ca5d2cd2cda1d245d34b1c9a942920a718082ae8e54e5f3e5a58b7add/pydantic_core-2.33.2-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:329467cecfb529c925cf2bbd4d60d2c509bc2fb52a20c1045bf09bb70971a9c1", size = 2066757, upload-time = "2025-04-23T18:33:30.645Z" },
 ]
 
+[[package]]
+name = "pydantic-docs"
+version = "0.0.1"
+source = { git = "https://github.com/pydantic/pydantic-docs#142645b6ec056bbe2f39cc313aff781fba15e326" }
+dependencies = [
+    { name = "click" },
+    { name = "markdown" },
+    { name = "mkdocs" },
+    { name = "mkdocs-material" },
+    { name = "pymdown-extensions" },
+    { name = "ruamel-yaml" },
+]
+
 [[package]]
 name = "pydantic-evals"
 source = { editable = "pydantic_evals" }