A short deck
HTML > Markdown
— for the things agents now make
Seven slides. Arrow keys to advance.
02 · The thesis
Markdown is a document format.
The agent is making artifacts.
Plans, comparisons, reviews, status reports, editors. Things you read once and act on, not files you edit by hand.
03 · What the format can carry
Information density
capability
markdown
html
headings, lists, links
yes
yes
tables
yes
yes
side-by-side layout
no
yes
real diagrams (SVG)
no
yes
color carrying meaning
no
yes
interactive controls
no
yes
round-trip editor
no
yes
open by browser link
no
yes
04 · Same content, two formats
"Compare three approaches"
as markdown
## Option 1: Inline
- Pro: zero deps
- Pro: easy to debug
- Con: duplicated everywhere
## Option 2: Custom hook
- Pro: reusable
- Pro: testable
- Con: one more file
## Option 3: Library
- Pro: edge cases handled
- Pro: well-tested
- Con: +1.4 kb
as html
01 · inlinezero deps · low reuse · +0 kb
02 · hookreusable · testable · +0.2 kb
03 · libraryedge cases · well-tested · +1.4 kb
Read horizontally. Pick one.
05 · Distribution
Markdown is an attachment.
HTML is a link.
📎
.md file
"Open it in your editor"
"Render it locally"
"Trust me, it's good"
🔗
.html link
paste in Slack
open on phone
actually read
06 · Two-way interaction
And the slide itself can do work.
A slider, on a slide, in a browser. Markdown can't.
07 · Closing
This deck is itself an HTML file.
One file. No build step. No PowerPoint, no Keynote, no export. Arrow keys you already know. Open it on any device. Share by link. Edit by re-prompting.
$ open 06-deck.html
1 / 7
← → navigate · F fullscreen