Foundations7 min read
How to Write Semantic HTML That Stays Useful
Choose elements for their meaning, build a clear document outline, and make your page easier to navigate, edit, and reuse.
Read guideThe HTML field guide
24 HTML best practices for fast, accessible pages.
Practical how-tos for the parts of HTML that determine whether a page remains useful: structure, accessibility, performance, publishing, and review.
A better default for every page
- Copy-ready examples with the reasoning behind them.
- Checks you can run before a page reaches production.
- Patterns that hold up when humans and agents both edit.
Start here
Four guides that improve almost any page.
Accessibility8 min read
How to Build Accessible HTML Forms
Connect every field to a label, group related controls, explain errors clearly, and make the full flow work from a keyboard.
Read guidePerformance8 min read
How to Serve Responsive Images in HTML
Use width, height, srcset, sizes, picture, and loading hints to deliver sharp images without wasting bandwidth.
Read guideCollaboration8 min read
How to Review AI-Generated HTML Before You Publish
Check structure, claims, accessibility, responsiveness, safety, and metadata with a repeatable human review pass.
Read guideAll guides
From the first doctype to the final review.
Browse the complete library, or jump to a topic using the section labels below.
Foundations
04 guidesFoundations6 min read
A Reusable HTML Page Structure for New Projects
Begin with a small, valid document shell that supports accessibility, responsive design, metadata, and progressive enhancement.
Read guideFoundations7 min read
How to Organize CSS Around Your HTML
Keep selectors shallow, components readable, and design tokens explicit so a page remains easy to revise after launch.
Read guideFoundations6 min read
How to Add Dark Mode Without Breaking Your HTML
Respect system preferences, preserve contrast, and keep native controls and embedded content legible in both themes.
Read guideFoundations7 min read
How to Use Progressive Enhancement in HTML
Ship a useful document first, then add styling and interaction without making the core task depend on them.
Read guideAccessibility
04 guidesAccessibility6 min read
How to Create a Clear HTML Heading Structure
Turn a visual page into a dependable outline that helps readers scan, navigate, and understand the content.
Read guideAccessibility7 min read
How to Make HTML Tables Easy to Read
Use captions, headers, scope, and responsive wrappers so dense data keeps its meaning on every screen.
Read guideAccessibility5 min read
Links or Buttons? How to Choose the Right HTML Control
Use links for navigation and buttons for actions, then write labels that make the result clear before someone clicks.
Read guideAccessibility8 min read
How to Make an HTML Dashboard Understandable
Give charts, filters, statuses, and data tables a clear reading order and useful text equivalents.
Read guidePerformance
01 guidesPerformance8 min read
A Practical HTML Performance Checklist
Reduce render-blocking work, prioritize the first viewport, and ship a smaller page before reaching for complex tooling.
Read guidePublishing
07 guidesPublishing7 min read
How to Write HTML Metadata for Search and Sharing
Create useful titles, descriptions, canonical URLs, and social cards without treating metadata as a bag of keywords.
Read guidePublishing7 min read
How to Add Structured Data to an HTML Page
Use JSON-LD to describe articles, organizations, products, and breadcrumbs without making claims the visible page cannot support.
Read guidePublishing7 min read
How to Make an HTML Page Print and Export Cleanly
Add print styles that preserve the document hierarchy, avoid awkward page breaks, and remove interface-only controls.
Read guidePublishing9 min read
How to Handle Untrusted HTML Safely
Treat imported markup as code, define an allowlist, isolate rendering, and avoid trusting a sanitized string forever.
Read guidePublishing8 min read
How to Build a Focused Landing Page in HTML
Create a fast, accessible page with one audience, one promise, and one primary action.
Read guidePublishing7 min read
How to Validate and Test HTML Before Release
Combine conformance checks, keyboard testing, responsive review, performance measurement, and content verification.
Read guidePublishing7 min read
How to Create Portable, Self-Contained HTML
Bundle the right assets, avoid fragile dependencies, and keep a standalone page understandable when it moves.
Read guideCollaboration
04 guidesCollaboration9 min read
How to Use contenteditable Without Losing Control
Define an editing model, preserve selection, normalize pasted markup, and separate transient DOM state from saved content.
Read guideCollaboration8 min read
How Shadow DOM Keeps Imported HTML Isolated
Understand style boundaries, event behavior, focus, and the tradeoffs of rendering third-party HTML inside a shadow root.
Read guideCollaboration7 min read
How to Hand Off an HTML Deliverable to a Client
Package the page, explain what is editable, collect precise feedback, and keep one current version through approval.
Read guideCollaboration7 min read
How to Run a Collaborative Review on an HTML Page
Set a review goal, collect anchored comments, resolve conflicts, and publish a clear final version.
Read guidePut the guides to work