Field notes on docs, AI, and the web

How great teams actually ship docs.

Long-form writing on documentation, AI-readable content, the editor we wish existed, and the change-management problem nobody talks about.

— Latest

Recent writing

Master nextjs environment variables. Learn about .env, public/private, build-time/runtime, and Vercel secrets in this practical guide.

Master the markdown blockquote: syntax, nesting, platform rendering, the 4 most common breakages, and when to ditch quotes for callouts.

Markdown can't center text natively — here's exactly which HTML workarounds render on GitHub, npm, MDX, Reddit, and 8 other platforms.

How to make a markdown horizontal line, the blank-line gotcha that breaks it, and how rendering differs across GitHub, GitLab, and MDX.

Every way to indent in markdown — nested lists, paragraphs, code blocks, MDX. Plus a platform-by-platform table of what actually renders.

The exact syntax for markdown superscript and subscript, which platforms support ^text^ and ~text~, and the HTML fallback that works everywhere.

Start for free

Join developers who chose simplicity over enterprise pricing. Instant setup, no git required.