HTML Deliverables Dramatically Outperform Markdown for Client Reception
1 What happened
The BizTalk migration analysis (RD-0002) was initially delivered as markdown files. When reformatted as interactive HTML with Claude-website aesthetic — collapsible sections, clickable diagrams, search — the client response shifted from "looks like notes" to "this is a professional deliverable." The same content, different format, completely different perceived value. This led to adopting HTML as the default deliverable format factory-wide.
2 What we learned
Format is not just presentation — it's perceived competence. For consulting deliverables, interactive HTML with professional styling signals "we built something for you" while markdown signals "we wrote some notes." The production cost difference is near-zero with Claude Code generating both, but the client value perception gap is enormous. Self-contained single-file HTML (no external dependencies) is the sweet spot: easy to share, works offline, looks polished.
3 Applies to
- All client-facing deliverables — default to HTML, never raw markdown