Add Markdown example and integration test

Updated Markdown documentation to include a new example image and code snippet. Added an integration test and golden image for Markdown rendering to improve test coverage and documentation clarity.

Author: InesaFitsner

sdk/python/packages/flet/docs/controls/markdown.md

@@ -1,10 +1,11 @@
 ---
 class_name: flet.Markdown
 examples: ../../examples/controls/markdown
-example_images: ../examples/controls/markdown/media
+example_images: ../test-images/examples/core/golden/macos/markdown
+example_media: ../examples/controls/markdown/media
 ---
 
-{{ class_summary(class_name) }}
+{{ class_summary(class_name, example_images + "/image_for_docs.png", image_caption="Basic Markdown") }}
 
 ## Examples
 
@@ -16,7 +17,7 @@ example_images: ../examples/controls/markdown/media
 --8<-- "{{ examples }}/basic.py"
 ```
 
-{{ image(example_images + "/basic.gif", alt="basic", width="80%") }}
+{{ image(example_media + "/basic.gif", alt="basic", width="80%") }}
 
 
 ### Code syntax highlight

sdk/python/packages/flet/integration_tests/examples/core/golden/macos/markdown/image_for_docs.png

@@ -0,0 +1,16 @@
+import pytest
+
+import flet as ft
+import flet.testing as ftt
+
+
+@pytest.mark.asyncio(loop_scope="function")
+async def test_image_for_docs(flet_app_function: ftt.FletTestApp, request):
+    flet_app_function.page.theme_mode = ft.ThemeMode.LIGHT
+    await flet_app_function.assert_control_screenshot(
+        request.node.name,
+        ft.Markdown(
+            value="# Welcome\n\nThis is **Markdown** rendered in Flet.",
+            width=260,
+        ),
+    )

sdk/python/packages/flet/integration_tests/examples/core/test_markdown.py

@@ -233,6 +233,13 @@ class MarkdownCustomCodeTheme:
 class Markdown(LayoutControl):
     """
     Renders text in markdown format.
+
+    ```python
+    ft.Markdown(
+        value="# Welcome\\n\\nThis is **Markdown** rendered in Flet.",
+        width=260,
+    )
+    ```
     """
 
     value: str = ""