HTML to Markdown
Converter

How to convert HTML to Markdown

1. Get the HTML as a file. For a web page, open it in your browser and save it with Ctrl+S (Cmd+S on a Mac) as HTML only.
2. Click Choose files or drop .html or .htm files onto the page.
3. Each file converts right away. There are no options to set.
4. Save the .md file, or Download all (.zip).

What converts to what

• Headings become # to ###### headings, from level 1 to level 6.
• Bold becomes double asterisks, italic becomes single asterisks, and strikethrough becomes double tildes.
• Links become [text](url) and images become , using the addresses exactly as they appear in the HTML.
• Bulleted lists use dashes, numbered lists stay numbered, and nested lists are indented.
• Code blocks become fenced blocks with three backticks, and inline code gets single backticks.
• Tables become GitHub-style pipe tables. The first row of each table is treated as the header row.
• Block quotes become lines starting with >, and horizontal rules become ---.

What is removed

Scripts, styles, noscript blocks, templates, iframes and embedded objects are dropped, along with everything in the head of the page, including the title. Table captions are also removed. Inline styles, classes and colors disappear because Markdown has no way to express them; the text inside those elements is kept.

The tool converts the whole body of the page. It doesn’t try to find the main article, so menus, sidebars, cookie notices and footers in a saved web page come through as text and links. Delete them in your editor, or copy only the part you want into a new HTML file before converting.

Common problems and fixes

• Backslashes appear before some characters. Characters like *, _ and a number followed by a period at the start of a line are escaped so they aren’t read as formatting. They disappear when the Markdown is rendered.
• A table looks misaligned. Merged cells (colspan or rowspan) can’t be expressed in Markdown tables, so rows may have different numbers of cells. Fix them by hand or simplify the table.
• Images don’t show. Image files aren’t downloaded; the Markdown links to the same address as the HTML. Relative paths only work if the images sit in the same place relative to the .md file.
• Line breaks inside a table cell are gone. Markdown table cells must be on one line, so breaks are replaced with spaces.
• Accented letters look garbled. The file is read as UTF-8. A page saved in an older encoding, such as Windows-1252, needs to be re-saved as UTF-8 in a text editor first.

Where the Markdown works

The output is plain Markdown with GitHub-style tables and strikethrough. It suits README files, wikis, static site generators like Hugo, Jekyll and Astro, note apps like Obsidian, and docs migrations from an old CMS. Converting back is just as easy with Markdown to HTML.

Privacy

The HTML is parsed by your browser and turned into Markdown with the Turndown library on your device. Nothing is fetched from the web during conversion and nothing is uploaded.