How to use the HTML to Markdown Converter
- 1. Paste HTMLFrom a web page, blog editor or email.
- 2. ConvertEach element becomes its Markdown equivalent.
- 3. Copy or downloadCopy the Markdown or save it as a .md file.
What is converted
- Headings h1–h6 → # to ######.
- <strong> and <b> → **bold**; <em> and <i> → _italic_; <del> → ~~strikethrough~~.
- Links → [text](url), images → .
- Bulleted and numbered lists, including nested lists, with 3-space indents.
- <pre><code class="language-python"> → a ```python fenced block, keeping the language.
- Tables → GitHub-style pipe tables, with | inside cells escaped.
- Blockquotes → > lines, and <hr> → ---.
Scripts, styles and anything with no Markdown equivalent, such as colours or layout boxes, are dropped, but their text content is kept.
Worked example
The sample HTML has a heading, a paragraph with bold and italic words, a nested list, a link, a Python code block and a small table. The Markdown starts:
# Python Basics
Python is **easy to read** and great for _beginners_.
- Variables
- Loops
- for
- whileThe link becomes [Uncodemy](https://uncodemy.com), the code block keeps its python language tag, and the table becomes | Type | Example | with a | --- | --- | separator line. Special Markdown characters in normal text, such as * and _, are escaped so they don't accidentally turn text bold or italic. This makes it easy to move old blog posts or documentation into GitHub, Notion or a static site generator.
Frequently asked questions
Which Markdown flavour does it use?
GitHub-flavoured Markdown, which adds tables and strikethrough to standard Markdown.
Are inline styles kept?
No. Markdown has no colours or fonts, so only the text and structure are kept.
Can I convert a whole web page?
Yes, but you will get menus and footers too. Copy just the article's HTML for the cleanest result.
Is the html to markdown converter free?
Yes, it is free. Your first conversion asks for your name and WhatsApp number once, and after that the html to markdown converter and every other Uncodemy tool open without the form.