Sample: what a blog post looks like on this site

This is a sample post. It exists so the layout can be reviewed with real headings, lists, quotes and a Sources section. It stays a draft, which means it renders on a developer's machine and on preview links, with the banner above, and never on the live site. Delete it once real posts exist, or keep it as a template.

The paragraph you are reading is body text. It is set in Satoshi at a comfortable reading width, roughly 65 to 70 characters per line, with generous space between paragraphs. Headlines are Chillax, sentence case, in Connected's teal. Links look like this link to the About page.

A second-level heading

Most posts will use second-level headings to break the argument into parts. Keep them short and plain. A reader should be able to skim the headings alone and know what the post argues.

Some things to notice on this page:

• The title at the top is the only first-level heading on the page.
• The summary under the title doubles as the description Google and social networks show.
• The date, the updated date, the author, the reviewer and the reading time all sit in one line above the graphic.
• The three related posts at the bottom come from the same category when there are enough of them.

A third-level heading

Third-level headings are for sub-points. Below is a quote, styled with a rule on the left.

A person reads it. Not a routing rule. The same day, and always someone who can answer the technical question directly.

And a numbered list, for steps:

1. Write the post as a draft.
2. Have someone review it.
3. Set the status to published and merge the pull request.

Images in the body

Body images use ordinary Markdown with the alt text in the square brackets. Alt text is required; it is what screen readers announce and what search engines index.

Closing

End with the point, not a summary of the points. One or two sentences that say what the reader should do or believe differently now.