Writing great pages

Last updated

Every inline style and simple block a writer uses, in one place.

Inline styles#

This sentence has bold, italic, bold italic, strikethrough, inline code and a link to the open web. Emoji work too: 🚀 ✅ 📘.

A very long word should wrap inside the column rather than push the page sideways: Pneumonoultramicroscopicsilicovolcanoconiosis-and-then-some-more-characters-to-be-sure.

A long URL as text: https://example.com/a/very/long/path/that/keeps/going/and/going/until/it/would/overflow/a/phone/screen?with=query&parameters=too

Lists#

Unordered, nested three deep:

  • Fruit

    • Citrus

      • Lemon

      • Lime

    • Berries

  • Vegetables

  • Grains

Ordered, starting at 5:

  1. Fifth

  2. Sixth

  3. Seventh

A checklist:

  • Done item

  • Open item

  • Another open item

Quotes#

Documentation is a love letter that you write to your future self.

— Damian Conway

A horizontal rule#

Above the line.


Below the line.

Footnotes#

Docs sites render footnotes at the end of the page.1 A second note shows they are numbered in order.2


  1. This is the first footnote.

  2. And this is the second, with bold in it.