diff --git a/core/commands/object/diff.go b/core/commands/object/diff.go
index 06fd1fab3d9d..46a53feaff74 100644
--- a/core/commands/object/diff.go
+++ b/core/commands/object/diff.go
@@ -17,29 +17,29 @@ type Changes struct {
 
 var ObjectDiffCmd = &cmds.Command{
 	Helptext: cmds.HelpText{
-		Tagline: "takes a diff of the two given objects",
+		Tagline: "Takes a diff of the two given objects.",
 		ShortDescription: `
-ipfs object diff is a command used to show the differences between
+'ipfs object diff' is a command used to show the differences between
 two ipfs objects.`,
 		LongDescription: `
-ipfs object diff is a command used to show the differences between
+'ipfs object diff' is a command used to show the differences between
 two ipfs objects.
 
 Example:
 
-   $ ls foo
+   > ls foo
    bar baz/ giraffe
-   $ ipfs add -r foo
+   > ipfs add -r foo
    ...
-   added QmegHcnrPgMwC7tBiMxChD54fgQMBUecNw9nE9UUU4x1bz foo
-   $ OBJ_A=QmegHcnrPgMwC7tBiMxChD54fgQMBUecNw9nE9UUU4x1bz
-   $ echo "different content" > foo/bar
-   $ ipfs add -r foo
+   Added QmegHcnrPgMwC7tBiMxChD54fgQMBUecNw9nE9UUU4x1bz foo
+   > OBJ_A=QmegHcnrPgMwC7tBiMxChD54fgQMBUecNw9nE9UUU4x1bz
+   > echo "different content" > foo/bar
+   > ipfs add -r foo
    ...
-   added QmcmRptkSPWhptCttgHg27QNDmnV33wAJyUkCnAvqD3eCD foo
-   $ OBJ_B=QmcmRptkSPWhptCttgHg27QNDmnV33wAJyUkCnAvqD3eCD
-   $ ipfs object diff -v $OBJ_A $OBJ_B
-   changed "bar" from QmNgd5cz2jNftnAHBhcRUGdtiaMzb5Rhjqd4etondHHST8 to QmRfFVsjSXkhFxrfWnLpMae2M4GBVsry6VAuYYcji5MiZb
+   Added QmcmRptkSPWhptCttgHg27QNDmnV33wAJyUkCnAvqD3eCD foo
+   > OBJ_B=QmcmRptkSPWhptCttgHg27QNDmnV33wAJyUkCnAvqD3eCD
+   > ipfs object diff -v $OBJ_A $OBJ_B
+   Changed "bar" from QmNgd5cz2jNftnAHBhcRUGdtiaMzb5Rhjqd4etondHHST8 to QmRfFVsjSXkhFxrfWnLpMae2M4GBVsry6VAuYYcji5MiZb.
 `,
 	},
 	Arguments: []cmds.Argument{
@@ -103,11 +103,11 @@ Example:
 				if verbose {
 					switch change.Type {
 					case dagutils.Add:
-						fmt.Fprintf(buf, "added new link %q pointing to %s\n", change.Path, change.After)
+						fmt.Fprintf(buf, "Added new link %q pointing to %s.\n", change.Path, change.After)
 					case dagutils.Mod:
-						fmt.Fprintf(buf, "changed %q from %s to %s\n", change.Path, change.Before, change.After)
+						fmt.Fprintf(buf, "Changed %q from %s to %s.\n", change.Path, change.Before, change.After)
 					case dagutils.Remove:
-						fmt.Fprintf(buf, "removed link %q (was %s)\n", change.Path, change.Before)
+						fmt.Fprintf(buf, "Removed link %q (was %s).\n", change.Path, change.Before)
 					}
 				} else {
 					switch change.Type {