docs: Fix examples

Author: pawamoy

docs/examples/model_noext.py

@@ -20,28 +20,33 @@ hide:
 
 /// tab | Pydantic model
 
-```python exec="1" result="python"
-print('--8<-- "docs/examples/model_ext.py"')
+```python
+--8<-- "examples/model_ext.py"
 ```
 
 ///
 
 /// tab | Without extension
 
+```md exec="true" updatetoc="false"
 ::: model_noext.ExampleModel
     options:
       heading_level: 3
+      skip_local_inventory: true
+```
 
 ///
 
-
 /// tab | With extension
 
+```md exec="true" updatetoc="false"
 ::: model_ext.ExampleModel
     options:
       heading_level: 3
       extensions:
       - griffe_pydantic
+      skip_local_inventory: true
+```
 
 ///
 

docs/index.md

@@ -0,0 +1,37 @@
+from typing import Any
+from pydantic import field_validator, model_validator, ConfigDict, BaseModel, Field
+
+
+class ExampleModel(BaseModel):
+    """An example model."""
+
+    model_config = ConfigDict(frozen=False)
+
+    field_without_default: str
+    """Shows the *[Required]* marker in the signature."""
+
+    field_plain_with_validator: int = 100
+    """Show standard field with type annotation."""
+
+    field_with_validator_and_alias: str = Field("FooBar", alias="BarFoo", validation_alias="BarFoo")
+    """Shows corresponding validator with link/anchor."""
+
+    field_with_constraints_and_description: int = Field(
+        default=5, ge=0, le=100, description="Shows constraints within doc string."
+    )
+
+    @field_validator("field_with_validator_and_alias", "field_without_default", mode="before")
+    @classmethod
+    def check_max_length_ten(cls, v) -> str:
+        """Show corresponding field with link/anchor."""
+        if len(v) >= 10:
+            raise ValueError("No more than 10 characters allowed")
+        return v
+
+    @model_validator(mode="before")
+    @classmethod
+    def lowercase_only(cls, data: dict[str, Any]) -> dict[str, Any]:
+        """Ensure that the field without a default is lowercase."""
+        if isinstance(data.get("field_without_default"), str):
+            data["field_without_default"] = data["field_without_default"].lower()
+        return data

docs/examples/model_ext.py examples/model_ext.pydocs/examples/model_ext.py renamed to examples/model_ext.py

@@ -147,6 +147,13 @@ name = "python"
 class = "python"
 validator = "markdown_exec.validator"
 format = "markdown_exec.formatter"
+[[project.markdown_extensions.pymdownx.superfences.custom_fences]]
+name = "md"
+class = "markdown"
+validator = "markdown_exec.validator"
+format = "markdown_exec.formatter"
+[project.markdown_extensions.pymdownx.blocks.tab]
+alternate_style = true
 [project.markdown_extensions.pymdownx.tabbed]
 alternate_style = true
 [project.markdown_extensions.pymdownx.tasklist]
@@ -159,7 +166,7 @@ configurations = [{targets.include = ["reference/api.md"]}]
 # Plugins configuration
 # ----------------------------------------------------------------------------
 [project.plugins.mkdocstrings.handlers.python]
-paths = ["src"]
+paths = ["src", "examples"]
 inventories = ["https://docs.python.org/3/objects.inv"]
 
 [project.plugins.mkdocstrings.handlers.python.options]