diff --git a/src/address.rs b/src/address.rs
index 6b63bd3..24c40b1 100644
--- a/src/address.rs
+++ b/src/address.rs
@@ -59,7 +59,7 @@ pub struct AddressParserOptions {
 impl AddressParserOptions {
     /// Create options for the address parser.
     ///
-    /// ## Examples
+    /// # Examples
     ///
     /// ```
     /// use rustpostal::address;
diff --git a/src/expand.rs b/src/expand.rs
index 6050bf1..f9eb71e 100644
--- a/src/expand.rs
+++ b/src/expand.rs
@@ -335,7 +335,7 @@ impl NormalizeOptions {
 
     /// Expand address into normalized variations using libpostal.
     ///
-    /// ## Examples
+    /// # Examples
     ///
     /// ```
     /// use std::ffi::NulError;
@@ -360,7 +360,7 @@ impl NormalizeOptions {
     /// }
     /// ```
     ///
-    /// ## Errors
+    /// # Errors
     ///
     /// The method will return an error if the supplied address
     /// contains an internal null byte. The error is represented by
@@ -415,7 +415,7 @@ impl<'a> IntoIterator for &'a mut NormalizedAddress {
 
 /// Normalize address with default options.
 ///
-/// ## Errors
+/// # Errors
 ///
 /// The method will return an error if the supplied address
 /// contains an internal null byte. The error is represented by
@@ -427,7 +427,7 @@ pub fn expand_address<'a>(address: &'a str) -> Result<NormalizedAddress, NulErro
 
 /// Normalize address with optional user-defined languages.
 ///
-/// ## Errors
+/// # Errors
 ///
 /// The method will return an error if the supplied address
 /// contains an internal null byte. The error is represented by
diff --git a/src/lib.rs b/src/lib.rs
index 604fba2..0675f74 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -46,7 +46,7 @@ unsafe fn teardown_classifier() {
 impl LibModules {
     /// Setup the necessary `libpostal` resources.
     ///
-    /// ## Examples
+    /// # Examples
     /// ```
     /// use rustpostal::error::SetupError;
     /// use rustpostal::LibModules;