Update README to reflect latest code changes

Add some info on when markdown files are reloaded, why this is done, and
manual pause/resume.