What converts, and how
The converter uses Turndown with its GitHub Flavored Markdown plugin, then tidies the result. Headings, paragraphs, bold, italic, links, images, lists, blockquotes, code blocks (with their language- class kept as the fence language), strikethrough and simple tables all have direct Markdown equivalents.
What can’t be represented
- Styling: colours, fonts, sizes and CSS classes. Markdown is structure only.
- Merged table cells: kept as HTML because pipe tables can’t span.
- Layout: columns, grids and positioned elements are flattened into reading order.
- Forms, scripts, iframes: removed.
Typical uses
Moving a blog from WordPress to a static site generator like Hugo, Astro or Jekyll; turning a Google Doc into a README; saving an article as notes in Obsidian; or cleaning up HTML email copy. After converting, run the output through the Markdown formatter to align tables and normalise lists.