Skip to content
Go back

Style Showcase: The Notebook's Rich Content

This is the kitchen sink — a living reference for the styled bits you can drop into any post. Copy the markdown, tweak the words, ship it.

Keyboard keys

Wrap a key in <kbd> tags and it renders as a pressed keycap in the Silkscreen pixel face:

Press Ctrl + C to copy, then Ctrl + V to paste.

Save with S. Hit Esc to bail, Enter to commit, Tab to move on.

Symbols fall back gracefully

Silkscreen has no glyph for or arrow keys, so those fall back to the mono font automatically. Plain-letter keys like Esc stay crisp and pixelated.

Sticky notes

Sticky notes are Obsidian-style callouts. The syntax is a blockquote with a [!type] tag on the first line. The type picks the color — the note is the same bright color in light and dark, because a sticky note is a sticky note.

Yellow — the default

Use note, info, summary, tldr, or todo. Good for asides and definitions.

Green — do this

Use tip, success, important, or example. Good for the move you actually want the reader to make.

Orange — watch out

Use warning, caution, question, or faq. Good for the “here be dragons” moment.

Pink — stop

Use danger, error, bug, or failure. Good for the thing that will bite.

Blue — someone said

Use quote or cite. Good for pulling in a voice that isn’t yours.

The markdown for that first one:

> [!note] Yellow — the default
> Use `note`, `info`, `summary`, `tldr`, or `todo`.

Code

Inline code renders in the Geist Pixel face — like npm run dev or git push origin main — so short commands read as little pixel chips.

Fenced code blocks stay in the readable mono font with syntax highlighting:

// A code block keeps Google Sans Code for legibility.
function greet(name: string): string {
  return `Hello, ${name} — welcome to the notebook.`;
}

Quotes

A regular blockquote (no [!type] tag) renders as a quiet, indented aside with an accent rule — distinct from the loud sticky notes above.

Lists

  1. Numbered when order matters
  2. Like steps in a recipe
  3. Or a sequence of moves

Definition lists

For a glossary — a term paired with its meaning — put the term on its own line and start the next line with a colon. It renders with the term in the hand-annotation face and the definition indented under it behind a dotted rule:

Notebook
A bound stack of pages for thinking on paper — and the metaphor this whole site is built on.
Marginalia
Notes scribbled in the margin, next to the thing they’re about.
A second definition works too — just add another marker line.

The markdown:

Notebook
: A bound stack of pages for thinking on paper.

Marginalia
: Notes scribbled in the margin.
: A second definition — just add another marker line.
Colon or tilde, your call

Start the definition line with either : or ~ — both render the same. Whichever you reach for in Obsidian carries straight over to the site.

Sometimes the term and its meaning want to sit on the same line — a table is too much furniture for two columns. Put a colon with a space on both sides and the definition runs on inline: the term goes bold, the colon does the separating, and anything that wraps hangs past the term.

Term bullet
A term and its definition sharing one line, split by a spaced colon.
Need a second paragraph? Start the next line with a colon and it stacks under the same term.
Hanging indent
The definition wraps under itself instead of back out to the margin, so the term stays the thing your eye lands on.

The markdown:

Term bullet : A term and its definition sharing one line.
: A second paragraph stacks under the same term.

Hanging indent : The definition wraps under itself.
The spaces are the whole trick

It has to be a colon with a space on both sides. That’s what keeps Note: this, 9:15, and https://… from turning themselves into glossary entries by accident — not one of them has a space in front of the colon.

A table

ElementFaceWhen to reach for it
<kbd>SilkscreenKeyboard keys
Inline codeGeist PixelShort commands, file names
Code blockGoogle SansMulti-line code
Sticky noteHand-annotatedAsides, warnings, callouts
Definition listHand-annotatedGlossaries, term + meaning

Images

Drop a file in public/images/ and reference it with an absolute path — ![alt text](/images/name.png). Images render bordered, centered, and click-to-zoom.

At Play Gang: David asks Ruby about New Year's resolutions; she can't find the perfect goal to address being inflexible

Footnotes

Here’s a claim that needs a source.1

Footnotes

  1. And here’s the footnote backing it up.

P.S. — Got a reaction, a story, or something I'm missing? Reply by email — it lands straight in my inbox, and I write back.


Share this post:


Previous Post
Why Does It Bug Me When People Tell Me I'm Passionate?
Next Post
Why I Will Pay For Fable