write examples in markdown
updated examples and README