Skip to content

HTML to Markdown

Turn HTML pages or snippets into clean, readable Markdown.

How to convert HTML to Markdown

Three steps, all in your browser.

  1. 1

    Add your document

    Drop or open a file, or paste text straight into the box.

  2. 2

    Check the preview

    The converted result updates as you type or change a setting.

  3. 3

    Download

    Save the converted file, or copy the text.

HTML to Markdown: what to know

HTML is precise but noisy to edit by hand. This converter turns HTML into clean Markdown in your browser: headings become # lines, lists become - or 1. items, emphasis becomes ** and _, code blocks become fenced blocks, and links and images keep their addresses. Drop a saved web page or an .html export and only the body is converted.

Everything that isn't content is removed first: scripts, styles, the head section, forms, iframes and embedded media. Inline styles and classes are dropped as well, so a page full of wrapper divs and spans comes out as straightforward text. Links that use javascript: are removed for safety.

Tables become GitHub-style pipe tables. The first row becomes the header, short rows are padded with empty cells, pipe characters inside cells are escaped and line breaks inside a cell are joined. Very complex tables with merged cells may need tidying by hand.

Popular uses

  • Moving blog posts from an old CMS to a Markdown-based site
  • Saving articles as Markdown notes for Obsidian or a wiki
  • Converting HTML documentation into a Git-friendly format
  • Cleaning up HTML exported from another tool

Tips for the best result

  • Delete menus and footers from the result; they're part of the page body, so they come through as text.
  • Relative links and image paths stay relative, so fix them if the Markdown will live elsewhere.
  • For pasting into Word instead, use HTML to Word.

Read how JustYourConvert works and our privacy details. Keep your original files and check a converted file before you replace anything.

Frequently asked questions

Yes. Drop a saved .html file and its body is converted, while the head, scripts, styles, forms and embedded media are dropped. Menus and footers are part of the body, so they come through as text and links you may want to delete.

Links become [text](url) and images become ![alt](src), with the addresses exactly as they appear in the HTML. Relative links stay relative, so update them if the Markdown will live somewhere else. Links that use javascript: are removed.

Yes. Tables become GitHub-style pipe tables with the first row as the header. Pipes inside cells are escaped, short rows are padded with empty cells and line breaks inside a cell are joined into one line.

No. Every live tool on JustYourConvert opens and converts your files inside your browser, on your own device. Nothing is sent to our servers, and the result is saved straight from your browser.

Yes. Every tool is free, with no sign-up, no watermark and no daily limit. Clearly labeled ads keep it that way.

Only your device's memory. Because the work happens in your browser, very large files can be slow on phones and older computers. Each tool says its practical limit under the drop area.