diff --git a/doc/advanced/configuring_routers.md b/doc/advanced/configuring_routers.md
index 8e6278db..eee5ce9a 100644
--- a/doc/advanced/configuring_routers.md
+++ b/doc/advanced/configuring_routers.md
@@ -1,4 +1,4 @@
-## Configuring Routers
+# Configuring Routers
 
 Routers can be configured via options. Options allow things like [`clojure.spec`](https://clojure.org/about/spec) validation for route data and fast, compiled handlers. The following options are available for the `reitit.core/router`:
 
diff --git a/doc/basics/name_based_routing.md b/doc/basics/name_based_routing.md
index 7b16b9ae..4836b72e 100644
--- a/doc/basics/name_based_routing.md
+++ b/doc/basics/name_based_routing.md
@@ -1,4 +1,4 @@
-## Name-based (reverse) Routing
+# Name-based (reverse) Routing
 
 All routes which have `:name` route data defined, can also be matched by name.
 
diff --git a/doc/basics/path_based_routing.md b/doc/basics/path_based_routing.md
index f9e5eaf6..fd0f814b 100644
--- a/doc/basics/path_based_routing.md
+++ b/doc/basics/path_based_routing.md
@@ -1,4 +1,4 @@
-## Path-based Routing
+# Path-based Routing
 
 Path-based routing is done using the `reitit.core/match-by-path` function. It takes the router and path as arguments and returns one of the following: