diff --git a/src/config.rs b/src/config.rs
index d532ba1..ed37d55 100644
--- a/src/config.rs
+++ b/src/config.rs
@@ -162,7 +162,7 @@ pub static CONFIG_VALUES: LazyLock<ConfigBuilder<DefaultState>> = LazyLock::new(
 
 /// Incluye los ajustes necesarios de la configuración anticipando valores por defecto.
 ///
-/// ### Sintaxis
+/// # Sintaxis
 ///
 /// Hay que añadir en nuestra librería el siguiente código:
 ///
@@ -182,7 +182,7 @@ pub static CONFIG_VALUES: LazyLock<ConfigBuilder<DefaultState>> = LazyLock::new(
 /// * **Lista de pares** con las claves TOML que requieran valores por defecto. Siguen la notación
 ///   `"seccion.subclave"` para coincidir con el árbol TOML.
 ///
-/// ### Ejemplo básico
+/// # Ejemplo básico
 ///
 /// ```rust,no_run
 /// use pagetop::prelude::*;
@@ -212,7 +212,7 @@ pub static CONFIG_VALUES: LazyLock<ConfigBuilder<DefaultState>> = LazyLock::new(
 /// }
 /// ```
 ///
-/// ### Buenas prácticas
+/// # Buenas prácticas
 ///
 /// * **Valores por defecto**. Declara un valor por defecto para cada clave obligatoria. Las claves
 ///   opcionales pueden ser `Option<T>`.
@@ -227,7 +227,7 @@ pub static CONFIG_VALUES: LazyLock<ConfigBuilder<DefaultState>> = LazyLock::new(
 /// * **Errores explícitos**. Si la deserialización falla, la macro lanzará un `panic!` con un
 ///   mensaje que indica la estructura problemática, facilitando la depuración.
 ///
-/// ### Requisitos
+/// # Requisitos
 ///
 /// * Dependencia `serde` con la *feature* `derive`.
 /// * Las claves deben coincidir con los campos (*snake case*) de tu estructura `Settings_Type`.
diff --git a/src/core/action/all.rs b/src/core/action/all.rs
index ffee9f5..7fff970 100644
--- a/src/core/action/all.rs
+++ b/src/core/action/all.rs
@@ -44,10 +44,12 @@ pub fn add_action(action: ActionBox) {
 /// acción específica.
 ///
 /// # Parámetros genéricos
+///
 /// - `A`: Tipo de acción que esperamos procesar. Debe implementar [`ActionDispatcher`].
 /// - `F`: Función asociada a cada acción, devuelve un valor de tipo `B`.
 ///
 /// # Ejemplo de uso
+///
 /// ```rust,ignore
 /// pub(crate) fn dispatch(component: &mut C, cx: &mut Context) {
 ///     dispatch_actions(
diff --git a/src/core/component/children.rs b/src/core/component/children.rs
index 38a626b..cba8c39 100644
--- a/src/core/component/children.rs
+++ b/src/core/component/children.rs
@@ -278,7 +278,8 @@ impl IntoIterator for Children {
 
     /// Consume la estructura `Children`, devolviendo un iterador que consume los elementos.
     ///
-    /// ### Ejemplo de uso:
+    /// # Ejemplo de uso:
+    ///
     /// ```rust#ignore
     /// let children = Children::new().with(child1).with(child2);
     /// for child in children {
@@ -296,7 +297,8 @@ impl<'a> IntoIterator for &'a Children {
 
     /// Itera sobre una referencia inmutable de `Children`, devolviendo un iterador de referencia.
     ///
-    /// ### Ejemplo de uso:
+    /// # Ejemplo de uso:
+    ///
     /// ```rust#ignore
     /// let children = Children::new().with(child1).with(child2);
     /// for child in &children {
@@ -314,7 +316,8 @@ impl<'a> IntoIterator for &'a mut Children {
 
     /// Itera sobre una referencia mutable de `Children`, devolviendo un iterador mutable.
     ///
-    /// ### Ejemplo de uso:
+    /// # Ejemplo de uso:
+    ///
     /// ```rust#ignore
     /// let mut children = Children::new().with(child1).with(child2);
     /// for child in &mut children {
diff --git a/src/html/opt_classes.rs b/src/html/opt_classes.rs
index bcec937..abb3ba4 100644
--- a/src/html/opt_classes.rs
+++ b/src/html/opt_classes.rs
@@ -21,12 +21,14 @@ pub enum ClassesOp {
 /// Permite construir y modificar dinámicamente con [`ClassesOp`] una lista de clases CSS
 /// normalizadas.
 ///
-/// ### Normalización
+/// # Normalización
+///
 /// - El [orden de las clases no es relevante](https://stackoverflow.com/a/1321712) en CSS.
 /// - No se permiten clases duplicadas.
 /// - Las clases vacías se ignoran.
 ///
 /// # Ejemplo
+///
 /// ```rust
 /// use pagetop::prelude::*;
 ///
diff --git a/src/html/opt_id.rs b/src/html/opt_id.rs
index 6f166b9..893ac6d 100644
--- a/src/html/opt_id.rs
+++ b/src/html/opt_id.rs
@@ -5,6 +5,7 @@ use crate::{builder_fn, AutoDefault};
 /// Este tipo encapsula `Option<String>` garantizando un valor normalizado para su uso.
 ///
 /// # Normalización
+///
 /// - Se eliminan los espacios al principio y al final.
 /// - Se sustituyen los espacios intermedios por guiones bajos (`_`).
 /// - Si el resultado es una cadena vacía, se guarda `None`.
diff --git a/src/html/opt_name.rs b/src/html/opt_name.rs
index c4e2e2e..aa74e3b 100644
--- a/src/html/opt_name.rs
+++ b/src/html/opt_name.rs
@@ -5,11 +5,12 @@ use crate::{builder_fn, AutoDefault};
 /// Este tipo encapsula `Option<String>` garantizando un valor normalizado para su uso.
 ///
 /// # Normalización
+///
 /// - Se eliminan los espacios al principio y al final.
 /// - Se sustituyen los espacios intermedios por guiones bajos (`_`).
 /// - Si el resultado es una cadena vacía, se guarda `None`.
 ///
-/// ## Ejemplo
+/// # Ejemplo
 ///
 /// ```rust
 /// use pagetop::prelude::*;
diff --git a/src/html/opt_string.rs b/src/html/opt_string.rs
index 5379597..5bfd9c7 100644
--- a/src/html/opt_string.rs
+++ b/src/html/opt_string.rs
@@ -5,6 +5,7 @@ use crate::{builder_fn, AutoDefault};
 /// Este tipo encapsula `Option<String>` garantizando un valor normalizado para su uso.
 ///
 /// # Normalización
+///
 /// - Se eliminan los espacios al principio y al final.
 /// - Si el resultado es una cadena vacía, se guarda `None`.
 ///