Markdown vs HTML: when to use which

HTML is the standard markup language for building web pages, giving fine-grained control over every element through tags. Markdown, on the other hand, is a notation that lets you write that HTML with far simpler symbols.

If you only need document structure (headings, lists, links), Markdown is fast and easy to read. When you need complex layout, specific attributes or style control, HTML is better. Conveniently, you can also mix HTML directly inside Markdown.

Writing in Markdown and converting to HTML at publish time is the most common workflow. Conversely, tidying HTML copied from the web into Markdown makes it easy to reuse as notes or docs.

AG MD supports conversion in both directions, so you can move between formats as the situation requires.