updated tool notes
fixed markup in readme