diff --git a/README.md b/README.md
index 22417db92af4894e8fd07f4e2365def324d553f4..37cd4dd009c8ea003c4c7020f8919fb05ed5a48a 100644
--- a/README.md
+++ b/README.md
@@ -15,20 +15,17 @@ submit-pol-job <outdir> <policy> <nodecount> <corespernode> <ram> <partition> <t
 ```
 Where the positional arguments are:
 
-outdir - the directory for the output files, should be global to cluster (e.g. /scratch of the user running the job)
-policy - path to the GPFS policy to execute (e.g. in ./policy directory) 
-nodecount - number of nodes in the cluster that will run the policy
-corespernode - number of cores on each node to reserve
-ram - ram per core, can use "G" for gigabytes
-partition - the partition to submit the job
-time - the time in minutes to reserve for the job
-
-Note: the resource reservation is imperfect.  The job wrapper calls a script `run-mmpol.sh` which 
-is responsible for executing the `mmapplypolicy` command.  
-The command is aligned to run on specific nodes by way of arguments to 
-mmapplypolicy.  The command is technically not run inside of the job reservation so the resource
-constraints are imperfect.  The goal is to use the scheduler to ensure the policy run does not conflict
-with existing resource allocations on the cluster.
+- **outdir** - the directory for the output files, should be global to cluster (e.g. /scratch of the user running the job)
+- **policy** - path to the GPFS policy to execute (e.g. in ./policy directory) 
+- **nodecount** - number of nodes in the cluster that will run the policy
+- **corespernode** - number of cores on each node to reserve
+- **ram** - ram per core, can use "G" for gigabytes
+- **partition** - the partition to submit the job
+- **time** - the time in minutes to reserve for the job
+
+Note: the resource reservation is imperfect.  The job wrapper calls a script `run-mmpol.sh` which is responsible for executing the `mmapplypolicy` command.  
+
+The command is aligned to run on specific nodes by way of arguments to mmapplypolicy.  The command is technically not run inside of the job reservation so the resource constraints are imperfect.  The goal is to use the scheduler to ensure the policy run does not conflict with existing resource allocations on the cluster.
 
 ## Running the policy "list-policy-external"
 
@@ -37,7 +34,8 @@ ASCII text file.  The output file can then be processed by down-stream to create
 patterns and use.
 
 An example invocation would be:
-```
+
+```shell
 submit-pol-job /path/to/output/dir \
      /absolute/path/policy/list-path-external \
 	 4 24 4G partition_name \
@@ -50,23 +48,16 @@ Some things to keep in mind:
 - use absolute paths for all directory arguments to avoid potential confusion
 - make sure the output dir has sufficient space to hold the resulting file listing (It could be 100's of Gigabytes for a large collection of files.)
 
-The slurm job output file will be local to the directory from which this command executed.  It can be 
-watched to observe progress in the generation of the file list.  A listing of 100's of millions of files
-may take a couple of hours to generate and consume serveral hundred gigabytes for the output file.
+The slurm job output file will be local to the directory from which this command executed.  It can be  watched to observe progress in the generation of the file list.  A listing of 100's of millions of files may take a couple of hours to generate and consume serveral hundred gigabytes for the output file.
 
 The output file in `/path/to/output/dir` is named as follows
 - a prefix of "list-${SLURM_JOBID}"
 - ".list" for the name of the policy rule type of "list"
 - a tag for the list name name defined in the policy file,  "list-gather" for `list-path-external` policy
 
-The output file contains one line per file object stored under the `/path/to/listed/dir`.  No directories
-or non-file objects are included in this listing.  Each entry is a space-seperated set of file attributes
-selected by the SHOW command in the LIST rule.  Entries are encoded according to RFC3986 URI percent 
-encoding.  This means all spaces and special characters will be encoded, making it easy to split lines
-into fields using the space separator.
+The output file contains one line per file object stored under the `/path/to/listed/dir`.  No directories or non-file objects are included in this listing.  Each entry is a space-seperated set of file attributes selected by the SHOW command in the LIST rule.  Entries are encoded according to RFC3986 URI percent encoding.  This means all spaces and special characters will be encoded, making it easy to split lines into fields using the space separator.
 
-The ouput file is an unsorted list of files in uncompressed ASCII.  Further processing is desireble
-to use less space for storage and provide organized collections of data.
+The ouput file is an unsorted list of files in uncompressed ASCII.  Further processing is desireble to use less space for storage and provide organized collections of data.
 
 ## Processing the output file
 
@@ -78,10 +69,7 @@ to use less space for storage and provide organized collections of data.
 
 ### Disk usage by top level directies
 
-A useful report is the top level directory (tld) report.  This is akin to running a `du -s *` in a
-directory of interest, but much faster since there is no walking of directory trees.  Only the list
-policy output file is used, reducing the operation to a parsing an summing of the data in the list
-policy output file.
+A useful report is the top level directory (tld) report.  This is akin to running a `du -s *` in a directory of interest, but much faster since there is no walking of directory trees.  Only the list policy output file is used, reducing the operation to a parsing an summing of the data in the list policy output file.
 
 ### Comparing directory similarity
 
@@ -89,7 +77,11 @@ policy output file.
 ## Scheduling regular policy runs via cron
 
 The policy run can be scheduled automatically with the cronwrapper script.
+
 Simpley add append the above script and arguments to the crownwrapper in a crontab line.
+
 For example to run it every morning at 4 am you would add:
 
+```shell
 0 4 * * * /path/to/cronwrapper submit-pol-job <outdir> <policy> <nodecount> <corespernode> <ram> <partition>
+```