The video discusses the argument that Markdown is an outdated and insufficient format for technical documentation and development workflows, proposing HTML as a superior alternative. The core of the argument, presented by Zach Rick from Entropic, suggests that Markdown's limited formatting capabilities (headings, bold, lists) are inadequate for modern needs. In contrast, HTML can support richer content like tables, CSS styling, SVG charts, interactive code, workflows, spatial data, and real images. The presenter emphasizes that when presented with HTML, development agents can render complex elements like charts accurately, rather than faking them as they might with Markdown. The key takeaway is that while Markdown is suitable for quick skimming, HTML is the format that colleagues will engage with more deeply. The video hints at five specific areas where adopting HTML would significantly improve the codebase and development process, encouraging viewers to watch the full video for detailed explanations.

DIY Smart Code

Markdown is dying, and the people killing it built good code.

Last week, Zach Rick from Entropic dropped a thesis that broke the dev internet. 750,000 views. The reply split. His claim, Markdown is the wrong format. For every spec, every plan, every PR write up. Almost all of it, out.

Why? Markdown can carry headings, bold, a bullet list. That is it. HTML can carry tables, CSS design. SVG charts, code, live interactions, workflows. Spatial data, real images. When you give it HTML, the agent stops faking the chart and just draws it.

Markdown is what your colleague will skim. HTML is what your colleague will open. There are five places where switching to HTML changes everything. Watch the full video to see why your codebase is about to look very different.

Markdown Can't Do This (HTML Can) #html #markdown #webdevelopment

Mark down is dying,
and the people killing it built good
code.
Last week, Zach Rick from Entropic
dropped a thesis that broke the dev
internet.
750,000 views. The reply split.
His claim, Mark down is the wrong
format.
For every spec, every plan, every PR
write up.
Almost all of it, out. Why? Mark down
can carry headings, bold, a bullet list.
That is it. HTML can carry tables, CSS
design.
SVG charts, code, live interactions,
workflows.
Spatial data, real images. When you give
it HTML, the agent stops faking the
chart and just draws it.
Mark down is what your colleague will
skim.
HTML is what your colleague will open.
There are five places where switching to
HTML changes everything.
Watch the full video to see why your
code base is about to look very
different.

Get Our Mobile App

Markdown Can't Do This (HTML Can) #html #markdown #webdevelopment

Transcription