diff --git a/src/uu/hostname/hostname.md b/src/uu/hostname/hostname.md
new file mode 100644
index 000000000..f9e852c4b
--- /dev/null
+++ b/src/uu/hostname/hostname.md
@@ -0,0 +1,7 @@
+# hostname
+
+```
+hostname [OPTION]... [HOSTNAME]
+```
+
+Display or set the system's host name.
diff --git a/src/uu/hostname/src/hostname.rs b/src/uu/hostname/src/hostname.rs
index 03e9fe2e0..0e959b471 100644
--- a/src/uu/hostname/src/hostname.rs
+++ b/src/uu/hostname/src/hostname.rs
@@ -16,11 +16,11 @@ use clap::{crate_version, Arg, ArgAction, ArgMatches, Command};
 
 use uucore::{
     error::{FromIo, UResult},
-    format_usage,
+    format_usage, help_about, help_usage,
 };
 
-static ABOUT: &str = "Display or set the system's host name.";
-const USAGE: &str = "{} [OPTION]... [HOSTNAME]";
+const ABOUT: &str = help_about!("hostname.md");
+const USAGE: &str = help_usage!("hostname.md");
 
 static OPT_DOMAIN: &str = "domain";
 static OPT_IP_ADDRESS: &str = "ip-address";