HTML to Markdown
Convert HTML to Markdown online for free — paste HTML code, or paste rich text copied straight from a web page, Google Docs, Word or an email, and get clean Markdown with GitHub-flavoured tables, strikethrough and task lists. Choose heading, bullet and link styles, preview the result, then copy or download a .md file.
100% private — everything runs in your browser. Conversion happens on your device; nothing is uploaded.
Converted with the open-source Turndown library plus GitHub-flavoured tables, strikethrough and task lists. Scripts and styles are stripped. Nothing you paste leaves your device.
How to convert HTML to Markdown
- Paste rich text into the box, or paste HTML code into the HTML panel.
- Choose heading, bullet and link styles.
- Check the Markdown and the preview.
- Copy it, or download the .md file.
What you can use it for
- Move blog posts and docs into Markdown-based sites
- Turn Google Docs or Word text into README files
- Clean up content for Notion, Obsidian and GitHub
- Prepare tidy text for AI prompts and knowledge bases
More free tools
Building for the web?
Format, minify, convert and generate code with our free, private developer tools.
See all free tools →Frequently asked questions
How do I convert a web page to Markdown?
Select the content on the page, copy it, and paste it into the rich-text box. The formatting is converted to Markdown instantly.
Are tables supported?
Yes — HTML tables become GitHub-flavoured Markdown tables.
Need the reverse?
Use our Markdown to HTML converter.
Is anything uploaded?
No. Conversion happens in your browser.
Why did my table stay as HTML?
A table becomes a Markdown table only when its first row is a header row, meaning th cells or a row inside thead. A table without one is kept in the Markdown as its original HTML. To get a Markdown table, change the first row's td cells to th in the HTML panel. The Markdown updates as you type, so you can check the result straight away.
What's the difference between ATX and Setext headings?
ATX, the default, puts hash marks before each heading: one # for a level-1 heading, two for level 2, and so on up to six. Underlined (Setext) puts level-1 and level-2 headings on their own line, underlined with = or – signs to the heading's length. Levels 3 to 6 keep the # style either way. The Bullets option sets -, * or + as the list marker.
What's the difference between inline and reference-style links?
Inline, the default, writes each link where it appears, as [link text](https://example.com), with any link title in quotes after the address. Reference-style keeps the addresses out of the running text: each link becomes [link text][1], numbered in order, and the addresses are listed together at the end of the Markdown as [1]: https://example.com. Changing the option updates the Markdown straight away.
How are code blocks, images and task lists converted?
Code inside pre and code tags becomes a fenced block with three backticks, and a language class such as language-js is kept after the opening fence. Images become , pointing to the original image rather than copying it. Checkboxes inside list items become [x] or [ ], struck-through text is wrapped in tildes, bold uses double asterisks and italics single asterisks.
What gets removed from my HTML?
Before converting, the tool deletes script, style, iframe, object, embed, link and meta elements, plus event attributes such as onclick and any attribute value that starts with javascript:. The preview is cleaned the same way, so scripts in pasted code aren't run on the page. Tags with no Markdown equivalent, such as span or div, are dropped while their text is kept.
Do I need an account, and can I use the Markdown commercially?
No account or sign-up is needed: paste your HTML or rich text and copy the result. The Markdown is made only from what you paste, with no credit, link or watermark added, so you can use it in personal, client and commercial work. The open-source Turndown library and its GitHub-flavoured Markdown plugin, which do the conversion, are released under the MIT licence. Make sure you have the rights to the content itself.
Why is the Markdown empty or missing formatting?
If the message 'The converter failed to load. Refresh and try again.' appears, the Turndown library couldn't be downloaded from cdn.jsdelivr.net, so check your connection and reload the page. If the paste box says '✓ Plain text pasted.', your clipboard held no formatting, so the text is kept as plain lines. Copy the original content again, or paste its HTML code into the HTML panel.
Can I convert a Word document or PDF straight to Markdown?
Yes, with two related tools. DOCX to Markdown takes a .docx file and converts headings, lists, links, tables and images, with images saved as separate files in a ZIP or embedded in the file. PDF to Markdown turns a PDF's headings, bold text and lists into a .md file. Both are linked under Related tools on this page.