diff --git a/README.md b/README.md
index da95f3d..070be6e 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,13 @@
-### Compile ipmid with default options:
+# phosphor-host-ipmid
+
+## Compile ipmid with default options:
 
 ```ascii
 meson builddir
 ninja -C builddir
 ```
 
-### Compile ipmid with yocto defaults:
+## Compile ipmid with yocto defaults:
 
 ```ascii
 meson builddir -Dbuildtype=minsize -Db_lto=true -Dtests=disabled
@@ -16,21 +18,21 @@
 configuration, meson automatically gets them via its wrap dependencies mentioned
 in `ipmid/subprojects`.
 
-### Enable/Disable meson wrap feature
+## Enable/Disable meson wrap feature
 
 ```ascii
 meson builddir -Dwrap_mode=nofallback
 ninja -C builddir
 ```
 
-### Enable debug traces
+## Enable debug traces
 
 ```ascii
 meson builddir -Dbuildtype=debug
 ninja -C builddir
 ```
 
-### Generate test coverage report:
+## Generate test coverage report:
 
 ```ascii
 meson builddir -Db_coverage=true -Dtests=enabled
diff --git a/docs/ipmi-network-format.md b/docs/ipmi-network-format.md
index bb1189b..140afd5 100644
--- a/docs/ipmi-network-format.md
+++ b/docs/ipmi-network-format.md
@@ -1,3 +1,5 @@
+# IPMI network format
+
 On platforms running AMI BMC firmware (Habanero and Firestone at the moment),
 the 'Get/Set' System Boot Options' command has been extended to allow overrides
 to the network configuration to be specified. In Petitboot this will cause any
diff --git a/scripts/entity-example.md b/scripts/entity-example.md
index c2c6f4b..4ca8924 100644
--- a/scripts/entity-example.md
+++ b/scripts/entity-example.md
@@ -1,3 +1,5 @@
+# Entity-example
+
 If your platform requires the entity container map, you can provide a json file
 of the format: