MSRX Tools

HTML to Markdown

Convert HTML back into tidy Markdown.

Everything runs inside your browser. Your files never leave your device.

Input

Result

The result appears here as you type.

Ask about HTML to Markdown

Questions about what this tool does, which option to pick, or what it can and cannot handle.

The question you type here is sent to an AI provider to be answered — your files and whatever you put in the tool above are not, and the assistant cannot see them. Answers are generated and can be wrong. The tool itself is not guessing: it runs deterministic code on your device.

About the HTML to Markdown

The reverse trip: taking HTML and producing Markdown. Useful when moving content out of a CMS, converting an article into something a static site generator can build, or turning a page into text a person can edit without fighting tags.

Headings, paragraphs, links, emphasis, lists, block quotes, code blocks and tables all convert. Scripts, styles and comments are dropped, since none of them has a Markdown equivalent and none belongs in the text.

The conversion is deliberately lossy, and understanding what it loses is the point of using it. Markdown has no way to express a colspan, a class, an inline style, a data attribute or a nested table. Everything presentational disappears, and what remains is the structure and the words. If a page's meaning depends on its layout, the Markdown will not carry it.

Where HTML has no equivalent at all, the tool keeps the tag rather than discarding the content — an iframe, a video element, a form. Markdown permits inline HTML, so those survive as literal markup for you to deal with, which is better than silently losing them.

Content pasted from a word processor is the difficult case. Word and Google Docs produce HTML dense with spans carrying inline styles, and the conversion strips all of it, which is usually what you wanted but occasionally removes emphasis that was applied as a style rather than as a bold tag. Check the result against the original if that distinction matters.

The output uses a consistent style — hyphens for bullets, asterisks for emphasis, ATX-style headings with hash marks — so a batch of converted documents does not arrive in three different conventions.

How to use it

  1. 1Paste the HTML, or the page source you want converted.
  2. 2Read the Markdown output.
  3. 3Check anything structural — tables with merged cells and nested layouts do not survive.
  4. 4Look for leftover HTML tags in the result: those are elements Markdown cannot express, kept rather than dropped.

Questions

Why is there still HTML in the output?
Because Markdown has no equivalent for those elements — an iframe, a video, a form. Markdown allows inline HTML, so they are kept as-is rather than silently discarded along with their content.
What happens to tables?
Simple tables convert to Markdown's pipe syntax. Merged cells, nested tables and cell alignment beyond the basic three options have no representation and are flattened.
Can I convert a whole web page?
You can paste the source, but the result will include navigation, footers and any other markup on the page. Copy the article element or the main content region rather than the entire document.
Why did my styling disappear?
Markdown carries structure, not presentation. Classes, inline styles, fonts and colours have nowhere to go. That is usually the reason to convert in the first place, but it does mean emphasis applied as a style rather than as a tag is lost.