This is a plain opening paragraph. It has bold text, italic text, bold and italic together, struck-through text and inline code. It also has a link to the About page, a link that opens another site and a bare address: https://docs.astro.build.
Smart punctuation should turn “straight quotes” into curly ones, it’s, don’t and ‘single quotes’ too. Two hyphens – like this – and three dots… should become proper dashes and an ellipsis.
Headings
Below are the heading levels a post can use. The big title above is the page title, so posts start at the second level.
A third-level heading
Third-level headings split a long section into parts. They don’t appear in the “On this page” list.
A fourth-level heading
Use this level sparingly. It is smaller and quieter than the others.
Lists
An unordered list:
- First item
- Second item with a longer line of text that wraps onto more than one line so you can see how the list handles wrapping at the edge of the column
- Third item
- A nested item
- Another nested item
- A third level, for completeness
An ordered list, which this blog shows as numbered steps:
- Write down who it’s for.
- Write down what it’s for.
- Show one example of good.
- A nested numbered item
- Another one
- Read it back as if you were the machine.
A task list:
- Draft the post
- Read it out loud
- Cut the first paragraph
- Publish
Quotes and rules
“A short block quote with an attribution on the next line.”
Someone Who Said It, Some Source
A longer block quote that runs across a few lines can be written as one paragraph. It should keep its left margin and its monospaced attribution style, and it should still read clearly when the text is long enough to wrap twice or even three times in a narrow column.
A horizontal rule separates two parts of a post:
And this is the paragraph after the rule.
Small inline elements
Press Ctrl + K to open the thing. Text can be highlighted when it matters. A chemical formula like H2O uses a subscript and an exponent like 103 uses a superscript. An abbreviation such as AI can carry a tooltip. A deleted word and an inserted word show an edit.
A definition list:
- Brief
- What you tell someone before they start work.
- Draft
- The first version, which is allowed to be bad.
Footnotes and a long paragraph
Footnotes are written in the text and collected at the bottom of the post.1 A second footnote works the same way.2 The paragraph then carries on for a while so the page has enough text to scroll, because a reading test needs real length. The quick brown fox jumps over the lazy dog, and the lazy dog, being a sensible animal, does not get up. Words go here to fill the line. More words go here to fill the next line. Words keep going until the paragraph is long enough to see how the line height, the column width and the spacing between paragraphs feel over several lines of text in a row.
A second long paragraph follows. It exists so there is a visible gap between paragraphs, and so the spacing can be judged. Test text is test text. It says nothing in particular and it says it for a good reason: the point is the shape of the page, not the sentences on it.