Text tool / 02

HTML to Markdown Converter

Turn HTML into clean Markdown for notes, READMEs, or a content migration.

HTML to Markdown Converter: TOEA converts headings, paragraphs, lists, links, images, emphasis, code, quotes, and rules into their Markdown equivalents, unwrapping unknown tags so no text is lost. Runs 100% locally in your browser with zero server file uploads.

Category
Text tools
Runs
In your browser
Cost
Free · no sign-up
Availability
Ready to use
HTML → Markdown deskLocal processing

Runs entirely in your browser

↥
Paste HTML below, or choose a file

Up to 5 MB · nothing is uploaded

Links, images, and relative paths

Link and image addresses are copied exactly as written, so a path such as /images/chart.png or ../about stays relative and breaks once the Markdown lives somewhere else. For a migration, change them to full URLs or move the images alongside the new files. An image keeps its alt text in the square brackets whatever order the attributes are in. An image with an empty or missing alt gets empty brackets, so add descriptions to those before publishing. Lazy-loaded images that keep their address only in data-src have no src and are reduced to their alt text.

Text that turns into Markdown

Characters in the text are not escaped, so some of them take on Markdown meaning: a paragraph starting with a number and a period, such as 1986. A good year, becomes a numbered list, one starting with - or > becomes a bullet or a quote, and words wrapped in asterisks or underscores become emphasis. Search the output for those before publishing. Nested lists and line breaks inside paragraphs are the other places where the structure most often needs a manual fix.

How to use it

  1. Paste HTML or choose a file.
  2. Check the Markdown.
  3. Copy or download it.

Privacy & limitations

The text is converted in your browser and never uploaded, which matters when the file is a config or an export you would rather not hand to a stranger. Script and style blocks are removed with their contents; everything else keeps its text.

Related tools

Frequently asked questions

What happens to tags with no Markdown equivalent?

They are unwrapped and their text is kept. Dropping them would silently lose content, which is worse than losing the formatting.

Are scripts and styles kept?

No. Both are removed along with their contents, since neither belongs in a Markdown document.

Will a whole web page convert cleanly?

Partly. Navigation, footers, and layout wrappers become stray lines of text, so trim to the article element before converting.

Are tables supported?

Not yet. Table cells are unwrapped to text rather than converted to Markdown table syntax.

Free tool · runs in your browser · no account required