Type to search the archive.

Styleguide

Every block an issue can carry, styled by the theme. Open this page's source to see how each one is written.

Heading one

Heading two

Heading three

Heading four

Text

Body copy sits at the reading measure the issue pages use. It carries bold and italic emphasis, inline code, and links that pick up the accent colour.

Quotes

A smaller list that gets opened is worth more than a big one that gets ignored.

Lists

  • Unordered items wrap against a hanging indent
  • Spacing matches the body rhythm
  • Nesting is styled two levels deep
  1. Numbered lists share the same measure
  2. The counter sits outside the text column
  3. Long items stay aligned

Tables

A table scrolls inside its own frame when a narrow screen cannot hold it, so it never drags the page sideways.

MetricTemplateNear-plain
Open rate41.2%43.8%
Click rate3.1%4.9%
Replies per issue619

Code

A fenced block is highlighted at build time, with one set of colours for each mode and no highlighter shipped to the reader.

<body style="margin: 0; padding: 24px 16px; background: #fff">
  <div style="max-width: 560px; margin: 0 auto; font: 16px/1.6 system-ui, sans-serif">
    <!-- the issue -->
  </div>
</body>

Pictures

A regular figure sits at the width of the reading column.

Regular width. Click it to open the lightbox. Photo by Codioful

A wide figure breaks out of the column to a comfortable picture width.

Wide. Photo by Codioful

Callouts

Toggles

A toggle hides detail until it is asked for

Useful for a long caveat, a worked example, or the answer to a question only some subscribers have.

Several can sit together as a short FAQ

Each one opens on its own, so a reader can take only the part they came for.

Bookmarks

A bookmark only needs a URL. The picture, the title and the description are read from the linked page's own Open Graph tags at build time, and a page that has none falls back to a plain card.

AstroAstro builds fast content sites, powerful web applications, dynamic server APIs, and everything in-between.AstroOpens in a new tabA page with no Open Graph tagsWith nothing to show, the card stays a plain row and falls back to the link's own host.example.comOpens in a new tab

Audio

A sample recording

Three seconds, for the shape of the player.

Files

A sample documentWhat a downloadable template or data set looks like in the reading column.PDF · 1 KB