ahotml is a way of thinking about html.
it asks how little structure a useful page needs before the content can speak for itself.
## why
web pages often become harder to read than they need to be. layers of wrappers, repeated tags, decoration, and prescribed layouts can hide the actual content.
ahotml keeps the page close to its source. that makes it easier to understand, easier to change, and more comfortable on a small screen. it also leaves more room for improvising, creating, and collaborating.
## the idea
start with ordinary html and keep only what helps:
+ clear text and a logical order
+ semantic tags where they add meaning
+ no redundant ceremony
+ mobile-first and offline-friendly pages
+ enough freedom to try something different
these are suggestions, not laws. ahotml values flexibility and simplicity more than one correct style.
## a small guide
write a page that works before adding anything to it. give it a title, a clear heading, and content that needs no explanation from the design.
use links, lists, images, and emphasis when they help the reader. keep the source close enough to the result that another person can read both and understand what happened.
ahotml shorthand can make that writing quicker: `+` starts a list, `#` through `######` make headings, and fenced lines hold code. a small local javascript layer renders the shorthand. without javascript, the page still leaves its source available to read.
try things. break the examples. keep whatever makes the page clearer.
ps: ahotml previously lived as troffhtml and ahoxushtml.
with love ♥️ · fupl · source 20260816Z2129
with love ❤️ 20260816z2329waw + fupl + archive - previous / next