fix syntax
also escape template tags in markdown codespan
start on blocks docs