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 Blockquote Syntax: Official CommonMark & MDX Reference
● markdownMay 25, 2026

Markdown Blockquote Syntax: Official CommonMark & MDX Reference

Official markdown blockquote syntax from the CommonMark spec: > lines, nesting with >>, and MDX support. Includes GitHub, GitLab, Reddit, Slack, and Discord rendering differences — and the 4 most common ways it breaks.

Center Text in Markdown with <div align="center">: GFM & CommonMark Support
● markdownMay 25, 2026

Center Text in Markdown with <div align="center">: GFM & CommonMark Support

Does <div align="center"> work in Markdown? GitHub Flavored Markdown allows raw HTML and renders it; CommonMark permits it but some parsers strip it. Full support table for GitHub, GitLab, npm, Reddit, and MDX.

Markdown Horizontal Rule (---): Three Hyphens Syntax & CommonMark Spec
● markdownMay 25, 2026

Markdown Horizontal Rule (---): Three Hyphens Syntax & CommonMark Spec

The markdown horizontal rule is three or more hyphens (---), asterisks (***), or underscores (___). Full CommonMark thematic-break spec, the blank-line rule, and how GitHub, GitLab, and MDX render it.

Markdown Indent: The Complete Guide (2026)
● 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 Superscript and Subscript: The Complete 2026 Guide
● 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