ready updates

some markdown related changes