This is the kitchen-sink template. Duplicate this file, rename it, rewrite the frontmatter, and start deleting sections you don’t need. Every other entry in Know / Templates is a deeper dive on one of the pieces below.
Frontmatter cheat sheet —
titleanddescriptionshow up on the listing card and at the top of the page;datedrives ordering (newest first);order(optional) is a tiebreaker that floats a post above others on the same day;tagsrender as clickable chips;draft: truehides a post from the site.
Lead / hook
Open with one or two sentences that say what the reader will get and why they should care. Headings on this page automatically become the floating table of contents, so write them like signposts.
Background
Set up the problem. Link out to prior art and drop a callout when something deserves emphasis.
The main thing
Show the work. Mix prose with code blocks, diagrams, and tables — whatever carries the idea fastest.
// A small, runnable snippet beats three paragraphs of description.
export function greet(name: string): string {
return `hello, ${name}`;
}Walkthrough / demo
Embed a video or link a file/PDF when a live artifact explains it better than text.
Wrap up
Summarize the takeaway in two or three bullets:
- What you built or learned.
- The one gotcha worth remembering.
- Where to go next.