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

markdown
markdownMay 25, 2026

Markdown Blockquote: The Complete Guide (2026)

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

markdown
markdownMay 25, 2026

How to Center Text in Markdown: The Complete 2026 Guide

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

markdown
markdownMay 25, 2026

Markdown Horizontal Line: The Complete Guide (2026)

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

markdown
markdownMay 25, 2026

Markdown Indent: The Complete Guide (2026)

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

markdown
markdownMay 25, 2026

Markdown Superscript and Subscript: The Complete 2026 Guide

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

7 Release Notes Format Examples for Humans & AI in 2026
release notes format examplesMay 25, 2026

7 Release Notes Format Examples for Humans & AI in 2026

Explore 7 release notes format examples, from changelogs to in-app notes. Learn to write updates that both users and AI agents can understand and act on.

Start for free

Ready to ship better docs?

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

Get started free
Blog - Dokly | Documentation Tips, Tutorials & Best Practices