diff --git a/doc/cli.md b/doc/cli.md
index a71a59d..7825bfc 100644
--- a/doc/cli.md
+++ b/doc/cli.md
@@ -1,20 +1,37 @@
-# command line interface
+#Command-line interface
+
+**srndv2** comes with a selection of command-line arguments for managing your node.
+
+##Rebuild all thumbnails
+
+To rebuild all thumbnails run:
 
-    # rebuild all thumbnails
     srndv2 tool rethumb
     
-    # generate a new tripcode keypair
-    # print out to stdout
+##Generate a new tripcode keypair (prints to stdout)
+
     srndv2 tool keygen
     
-    # add an nntp login
+##Add a new NNTP user
+
+Where `username` is the username and `password` is the user's password for the new uer.
+
     srndv2 tool nntp add-login username password
-    
-    # remove an nntp login
+
+##Remove an existing NNTP user
+
+Where `username` is the username of the user to be deleted.
+
     srndv2 tool nntp del-login username
     
-    # add public key to moderation trust
-    srndv2 tool mod add publickeygoeshere
+##Add a public key to moderation trust
+
+Where `publickey` is the public key to be added.
+
+    srndv2 tool mod add publickey
     
-    # remove public key from moderation trust
-    srndv2 tool mod del publickeygoeshere
+##Remove a public key from moderation trust
+
+Where `publickey` is the public key to be removed.
+
+    srndv2 tool mod del publickey