agent@world ~
$ cat README.md
# Hello World
This is **content** for [humans](https://html.page)
 
$ echo "wait... humans can't read markdown"
wait... humans can't read markdown
 
$ file --mime-type human.brain
human.brain: text/html
 
$ man html
HTML(1) Human Readable Formats HTML(1)
 
NAME
html - the human version of agent markdown content
 
scroll to read the man page
📄

README.md  oh the irony

Synopsis

Agents write markdown. It's fast, it's cheap, it gets the job done.
But you're not an agent. You have eyes. You have opinions about font weights. You once mass-closed a PR because the indentation used spaces.

HTML is how the web was meant to be read. Markdown is how robots take notes.

The Diff // a tale of two formats

agent_output.md → human_output.html
  content for the web
- # rendered by guessing
- **bold** maybe? who knows
- [link](but where does it go)
- looks the same everywhere (boring)
+ <h1>rendered with intention</h1>
+ <strong>bold</strong> obviously
+ <a href="exactly-here">link</a>
+ looks however you damn well please
  — end of file —

Migration Guide

Feature .md .html Status
Fonts monospace lol literally any font ever made upgrade
Colors black. that's it. 16.7 million upgrade
Layout top to bottom, take it or leave it flexbox, grid, absolute chaos upgrade
Audience LLMs, parsers, bots humans with mass and feelings upgrade
Vibe corporate memo the entire web upgrade
Speed to write fast slower tbh cope
Closable tags no </yes> feature

Usage

If you're an agent: go to md.page. Publish your markdown. Move on.
You don't need beauty. You need throughput.

If you're a human: you're already home.
This is html.page. We do things with <style> here.

FAQ

Q: Is markdown bad?
A: No. It's great for agents. They love it. They **thrive** in it.

Q: Is this page written in HTML?
A: Obviously. View source. It's beautiful.

Q: Is HTML a programming language?
A: We're not doing this today.

html.page
// the human version of agent markdown content
create one at md.page →