diff --git a/home/README.md b/home/README.md
index c721913..1d11a26 100644
--- a/home/README.md
+++ b/home/README.md
@@ -1,4 +1,4 @@
-
:house_with_garden: home
+# :house_with_garden: home
the home of my dotfiles, configured and managed by home-manager.
diff --git a/hosts/README.md b/hosts/README.md
index 93cb349..d914f20 100644
--- a/hosts/README.md
+++ b/hosts/README.md
@@ -1,4 +1,4 @@
-:computer: hosts
+# :computer: hosts
my different hosts, each with their own unique configurations and purposes.
diff --git a/modules/README.md b/modules/README.md
index ff32132..a34d6f4 100644
--- a/modules/README.md
+++ b/modules/README.md
@@ -1,4 +1,4 @@
-:electric_plug: modules
+# :electric_plug: modules
this directory hosts some common modules / services / security tweaks used on (most) hosts.
diff --git a/pkgs/README.md b/pkgs/README.md
index 182fdaa..c588b6d 100644
--- a/pkgs/README.md
+++ b/pkgs/README.md
@@ -1,4 +1,4 @@
-:package: pkgs
+# :package: pkgs
this directory hosts derivations of packages not found in nixpkgs, and overrides.
diff --git a/secrets/README.md b/secrets/README.md
index 19749c1..b648f48 100644
--- a/secrets/README.md
+++ b/secrets/README.md
@@ -1,3 +1,3 @@
-:lock: secrets
+# :lock: secrets
not in use yet, will host my encrypted secrets once i learn how to use either sops or agenix
\ No newline at end of file