Getting an AI to write pages instead of Markdown

Left alone, most agents write Markdown. That is the right format for a file you read in a terminal, and the wrong one for something you want to look at.

Ask for a single self-contained HTML file. Three qualifiers do the work:

• Self-contained. The styles inside the file, rather than in a separate stylesheet beside it.
• Images inlined. Carried inside the page, rather than in a sibling folder that can be moved away from it.
• No build step and no server. The file should open by itself.

That matters because a page in your Showspace is a document you will still be opening in five years. A page that depends on a stylesheet next door, a font fetched from a website, or a build that has to run first will eventually open wrong. One file has no such dependencies.

Pages render in a sandbox, so ask for a page that keeps everything it needs inside itself. localStorage, session storage and cookies all fail there.