first crack at autogenerating a markdown of syntax examples
make header text less ambiguous