HTML.md

Published on May 5, 2026, filed under development, html, ai. (Share this post, e.g., on Mastodon.)

AGENTS.md, ACCESSIBILITY.md but also A11Y.md, DESIGN.md—as well as taste.md.

Following this trend of specialized specification files, here is a draft for HTML.md (gist)—foundational instructions you need for writing HTML, geared towards both humans and machines (if only to improve parsing and save tokens).

* Use the elements most appropriate semantically.
* Use as little HTML as possible.
* Validate all HTML output against an HTML validator (preferably the W3C one), and fix any errors.

That’s it.

Is this a joke?

No: While these instructions are opinionated insofar as they reflect a school of minimal web development honoring the first rule of ARIA and suggesting no use of optional markup, they acknowledge the reality that the HTML code on most websites often isn’t using the right elements for the job (e.g., divitis) and that it’s essentially never error-free (i.e., commonly invalid). Note, then, that this guidance intentionally doesn’t handle “everything,” like accessibility, performance, and search optimization, but the foundation.

Although we can memorize the three instructions, it is useful to document them in writing.

Whether that’s actually in form of an “HTML.md,” however, that’s everyone’s individual call. So this is not a serious request for this particular file convention—but one for us to pay more attention to HTML quality.

About Me

I’m Jens (long: Jens Oliver Meiert), and I’m an engineering lead, guerrilla philosopher, and indie publisher. I’ve worked as a technical lead and engineering manager at various companies (e.g., Google); I’m an active web and tool developer (code optimization, digital defense), a contributor to web standards (like HTML, CSS, WCAG), and a book author (O’Reilly, Frontend Dogma).

I love trying things—in web development and engineering management, but also in politics and philosophy, where I hold to one idea in particular: that we can only be well if we take good care of everyone. Here on meiert.com I talk about some of my perspectives and experiences. (Interpret charitably but be critical—and share feedback and advice that makes my work better.)