Skip to content

First note

What the editor can do, and what each block looks like once it is published.

1 min

This post lives at content/posts/notes/first-note.mdoc, so the URL is /notes/first-note. The folder it sits in becomes a tag, which is why notes appears below even though it is not in the tag list.

Headings set the structure

An H2 carries a rule above it, so sections are visible while scrolling rather than only while reading.

H3 is a step down

And an H4 is a label rather than a smaller heading — same family, case and tracking as every other piece of metadata on the site.

Labelled like this

Images carry captions

cover.jpg2000 × 1324
A Honda Civic
Images are measured at build time, so they are served at the size the layout actually needs.
Images are measured at build time, so they are served at the size the layout actually needs.

Toggles hide the long version

The long version

Toggle blocks are native <details>, so they open without JavaScript and screen readers announce them as disclosures.

Code is highlighted at build time

ts
export function greet(name: string) {
  return `hello ${name}`;
}

Keep reading