HTML First · ViewSource · Pandoc · Zero Build · Semantic Web

Using HTML as
First Class
Authoring
Environment

Pradeep Gowda
May 2026
01 / 11

Contents

01 / Problem

The toolchain trap

Why every authoring tool becomes a walled garden.

02 / Principles

HTML First

Three primitives that make HTML a complete authoring system.

03 / Stack

The minimal pipeline

From markdown to live URL in five moves, zero build config.

04 / Numbers

The case by the data

What 30 years of HTML's durability actually looks like.

05 / Ecosystem

The stack today

Authoring, publishing, and generating HTML in 2026.

06 / Action

Try it this week

Three things to ship before the next standup.

02 / 11
Section · The Problem
01
Every tool is a walled garden.

The
Toolchain
Trap.

We keep building new layers on top of the web while the web's own native language — the most durable, portable, view-source-able format ever shipped — sits underused directly beneath us.

03 / 11

HTML First

Three primitives
01

Default browser capabilities

Leverage what modern browsers already do. No framework, no polyfill, no ceremony. The platform ships features faster than any library.

02

Attribute syntax simplicity

The simplest API ever designed for behavior. One attribute adds interaction. No component model, no build step, no mental overhead.

03

ViewSource affordance

The most democratic debugging tool in software. Inspect any page. Learn from it. Adapt it. HTML is the only authoring format that teaches itself.

04 / 11

From markdown
to live URL
in five moves.

A repeatable pipeline that requires zero build infrastructure and survives any hosting provider or tool change.
01 · Write

Markdown

Author in plain text. Any editor works. No account required. File lives on your machine.

02 · Convert

Pandoc

One command. Clean, semantic HTML out. Works offline. Zero configuration needed.

03 · Style

50-line CSS

A single minimal stylesheet handles typography, spacing, and reading comfort. Nothing else.

04 · Review

Open in Browser

Double-click the file. No dev server. No install. No port. It just opens and works.

05 · Deploy

Drop & Ship

Drag the folder to Cloudflare Pages or Netlify Drop. Live URL in under 60 seconds.

Output

Permanent URL

A view-source-able, offline-capable, dependency-free page that will still open in 2046.

Plain Text pandoc -o out.html One stylesheet File protocol Drag & drop Total · < 10 min
05 / 11
30+
Years on the open web

HTML in
numbers

No authoring format has shipped to more devices, survived more platform shifts, or required fewer dependencies than plain HTML. The web's native language is also its most durable one.

Case for HTML · 2026
1 file
Complete document
0
Build steps required
Lifespan (well-formed HTML)
Browser compatibility
100%
06 / 11
Section · The Ecosystem
02
The stack exists right now.

It just
works.

Modern tooling built around HTML's strengths — not against them. Every piece of this stack is available today, runs without an account, and gets out of the way.

07 / 11
The Ecosystem · 2026

A complete HTML-first stack exists right now.

Authoring

Start here. Write in plain text, convert with a single command, style with minimal CSS.

  • Markdown + Pandoc — Any markdown file becomes clean semantic HTML. One command.
  • Quartz / SSG — Static site generator that turns a folder of markdown into a linked digital garden.
  • Semantic HTML conventions — Article, aside, nav, main: browser-native structure that search engines and screen readers already understand.
htmlforpeople.com · html-first.com

Publishing

Drop a folder. Get a URL.
  • here.now — Instant web hosting for agents and humans. No config.
  • aired.sh — Publish HTML artifacts instantly. Built for agentic output.
  • Cloudflare Pages — Drag a folder. Global CDN. Free tier covers most use cases.
  • Netlify Drop — Drop a folder in the browser. Live in under 30 seconds.
Zero config · Zero cost to start

Generating

When HTML is the target format, agents can generate it directly — no compilation, no build step.

  • beautiful-html-templates — Agent-ready slide template library. Pick, clone, populate.
  • Claude Code / HTML — "The Unreasonable Effectiveness of HTML" — agents produce deployment-ready pages natively.
  • frontend-slides — Beautiful browser-native slides using Claude's frontend skills.
  • EHTML — Custom elements for AJAX and interactivity without writing JavaScript.
github.com/zarazhangrui · e-html.org
08 / 11
The Unreasonable Effectiveness of HTML
"
HTML is not a stepping stone to something better. It is the something better. The platform shipped the answer thirty years ago. We just kept building abstractions over it.
The Unreasonable Effectiveness of HTML · 2025
@trq212
09 / 11

HTML vs
the
alternatives.

Scored against the properties that matter for long-lived, ownable, portable web content. Hint: HTML wins every row that compounds over time.
Property
HTML
Notion
Substack
WordPress
ViewSource
Native
None
None
Theme only
Permanent URLs
You control it
Notion.so
Substack.com
If self-hosted
Zero dependencies
Yes
Platform lock
Platform lock
Plugin chain
Offline-ready
File protocol
Cloud only
Cloud only
With cache
Owns the output
100%
Vendor
Vendor
Mostly
10 / 11
Three things to try this week

Try it
now.

01 · Today

Author one page in HTML

Pick a memo, a README, or a meeting summary. Write it as a single HTML file. No framework. Open it in the browser with double-click.

≈ 30 minutes
02 · This week

Strip a stylesheet

Take any page you already maintain. Remove everything except a single 50-line CSS file. Measure what breaks. Ship what doesn't.

≈ 2–3 hours
03 · This month

Move one workflow to HTML

Replace one Notion doc, Google Doc, or Confluence page with a plain HTML file hosted on Cloudflare Pages. Measure the difference.

11 / 11