Write some Docs

Markdown Habits That Stuck

After a few hundred notes, some habits earned their keep.

Lead with a sentence, not a heading

A note that opens with a real sentence gives the home-page cards something human to quote. Headings make terrible summaries.

Use tables sparingly, but use them

When something is genuinely tabular, nothing else compares:

HabitPayoff
One idea per fileEasy to link, easy to move
Consistent datesReliable ordering
Short excerptsBetter cards and previews

Code blocks are for code

// Resist the urge to put prose in here.
const note = "keep it for the things that are actually code";

That's the list. Small habits, compounding returns.