docs: add DivIcon text label example to icons guide (#2227)

* docs: add DivIcon text label example to icons guide

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: Sebastian Balanta <balantah@javerianacali.edu.co>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: 3 people

docs/user_guide/ui_elements/icons.md

@@ -54,3 +54,33 @@ folium.Marker(
 
 m
 ```
+
+## Text labels with DivIcon
+
+`DivIcon` allows you to add text directly on the map using an HTML `div` element.
+This is useful when you want a visible label at a specific location, without
+relying on tooltips or popups that only appear on interaction.
+
+```{code-cell} ipython3
+m = folium.Map(location=[41, -71], zoom_start=6)
+
+folium.Marker(
+    location=[41, -71],
+    icon=folium.DivIcon(
+        html='<div style="font-size: 14px; color: black; font-weight: bold;">New York</div>',
+        icon_size=(100, 36),
+        icon_anchor=(50, 18),
+    ),
+).add_to(m)
+
+folium.Marker(
+    location=[42.36, -71.06],
+    icon=folium.DivIcon(
+        html='<div style="font-size: 12px; color: navy;">Boston</div>',
+        icon_size=(80, 30),
+        icon_anchor=(40, 15),
+    ),
+).add_to(m)
+
+m
+```