Properly format markdown code blocks

The YAML configuration examples were being parsed as markdown, which
resulted in poorly formatted documents.

Also convert tempest element README file to markdown for consistency.

Change-Id: Id6def1c8bcb86e37f10a74bf85361a9da0d151b6
Closes-Bug: 1328304
Merge "Properly format markdown code blocks"