HTML to Markdown

The HTML to Markdown converter turns HTML into clean Markdown — useful for migrating blog posts and CMS content to a Markdown-based system, converting content copied from a web page into personal notes, or preparing documentation for a Git repository from an HTML source.

It comes up constantly during platform migrations: moving posts out of WordPress or another CMS into a static site generator like Hugo, Jekyll or Astro that expects Markdown source files; clipping an article's HTML into a note-taking app without dragging along inline styles and tracking scripts; and cleaning up the HTML a rich-text editor produces so it can be stored as Markdown in a database or version-controlled alongside code. Because it's a genuine html to markdown converter rather than a set of regex replacements, it copes correctly with nested formatting — bold text inside a list item inside a blockquote, for instance — that a naive find-and-replace approach breaks on.

It parses the HTML with a real DOM parser rather than pattern-matching tags, then walks the resulting tree to convert headings, paragraphs, bold and italic text, links, images, ordered and unordered lists, blockquotes, inline code and fenced code blocks into their Markdown equivalents. Layout elements with no Markdown equivalent — div, span and similar wrappers — are unwrapped so their text content survives while the tag itself is dropped, and script and style tags are removed entirely rather than converted, so tracking code and CSS never leak into the output.

For best results, paste just the article or main-content HTML rather than an entire page including header, navigation and footer markup — the converter will still process a full page, but the Markdown output will include navigation link lists and footer boilerplate you probably don't want mixed in with the article body.