updates to markdown version, notes