diff --git a/docs/lib/default.nix b/docs/lib/default.nix
index 641e5e0e..e105ac23 100644
--- a/docs/lib/default.nix
+++ b/docs/lib/default.nix
@@ -100,22 +100,19 @@ let
             > functions.md
           fi
 
-          default_heading="# $name"
-          if [[ -n "$title" ]]; then
-            default_heading+=": $title"
-          fi
-
-          print_heading=true
+          print_title=true
           if [[ -f "$md_file" ]] && [[ "$(head --lines 1 "$md_file")" == '# '* ]]; then
-            >&2 echo "NOTE: markdown file for $name starts with a <h1> heading. Skipping default heading \"$default_heading\"."
-            >&2 echo "      Found \"$(head --lines 1 "$md_file")\" in: $md_file"
-            print_heading=false
+            if [[ -n "$title" ]]; then
+              >&2 echo "NOTE: markdown file for $name starts with a <h1> heading. Skipping title \"$title\"."
+              >&2 echo "      Found \"$(head --lines 1 "$md_file")\" in: $md_file"
+            fi
+            print_title=false
           fi
 
           mkdir -p $(dirname "$out_file")
           (
-            if [[ "$print_heading" = true ]]; then
-              echo "$default_heading"
+            if [[ "$print_title" = true ]]; then
+              echo "# $title"
               echo
             fi
             if [[ -f "$md_file" ]]; then
diff --git a/docs/lib/pages.nix b/docs/lib/pages.nix
index b5e42f82..deeb9051 100644
--- a/docs/lib/pages.nix
+++ b/docs/lib/pages.nix
@@ -6,16 +6,16 @@
 {
   lib.nixvim = {
     _page = {
-      title = "Nixvim's functions";
+      title = "lib.nixvim: Nixvim's functions";
       source = ./index.md;
     };
 
     utils._page = {
-      title = "utility functions";
+      title = "lib.nixvim.utils: utility functions";
       functions.file = ../../lib/utils.nix;
     };
     lua._page = {
-      title = "lua functions";
+      title = "lib.nixvim.lua: lua functions";
       functions.file = ../../lib/to-lua.nix;
     };
   };