[kebman]

HTML is a structured document format designed for publishing content online. It gives precise control over elements such as headings, links, images, sections, forms, styling hooks, and layout behaviour in the browser. But the cost is complexity.

Markdown is a lightweight document format that leans toward easy writing, reading, and sharing. It is much simpler than HTML, easier to edit by hand, and works well for notes, documentation, drafts, README files, and content that may later be converted into HTML, PDF, or other formats.

That's why I'll continue to use Markdown for most of my notes and documentation, while I'll only use HTML for "public facing" documents.