What HTML elements are converted?

Headings (h1-h6), paragraphs, bold, italic, links, images, unordered and ordered lists, blockquotes, horizontal rules, line breaks, and pre/code blocks are all converted to their Markdown equivalents.

What happens to unsupported HTML?

HTML tags that have no Markdown equivalent are stripped, keeping only their text content. HTML entities like &, <, and > are decoded to their characters.

Can I convert a full web page?

You can paste any HTML snippet or full page HTML. For best results, paste just the content area (inside the main or article tag) rather than the full page including head and navigation.

HTML to Markdown Converter — Convert HTML Online

HTML input

0 bytes

About the HTML to Markdown Converter

Converting HTML to Markdown is useful when migrating content from a CMS to a static site generator, from web pages to README files, or to Markdown-based platforms like GitHub, Notion, or Obsidian. Markdown is cleaner, more portable, and easier to version-control in Git than HTML.

What converts cleanly and what does not

Converts well — headings (h1-h6), paragraphs, bold, italic, unordered and ordered lists, links, images, blockquotes, inline code, and fenced code blocks.
Lossy conversion — tables (supported in GitHub Flavoured Markdown), inline styles, and CSS classes lose their styling information.
Dropped entirely — <script>, <style> blocks, form elements, and non-semantic <div>/<span> wrappers have no Markdown equivalent.

Common workflow

Copy HTML from a browser's View Source (Ctrl+U) or DevTools Elements panel, paste into this converter, and get clean Markdown. For best results, copy only the article body rather than the full page HTML including navigation, sidebars, and footer markup.

Markdown for documentation and wikis

Static site generators (Jekyll, Hugo, Eleventy, Astro) use Markdown as their content format. Documentation platforms (GitBook, Docusaurus, MkDocs) do the same. When migrating existing HTML documentation to one of these platforms, converting HTML to Markdown is a necessary first step. This tool handles the bulk conversion; manual cleanup of complex layouts is usually needed afterwards.

Jekyll/Hugo sites — post content is written in Markdown; templates handle HTML wrapping
GitHub wikis — entirely Markdown-based; paste converted content directly
Docusaurus/MkDocs — documentation sites use .md files; conversion lets you migrate existing HTML docs
Obsidian notes — convert web articles to Markdown for local storage in your personal knowledge base

Frequently Asked Questions

Why would I convert HTML to Markdown?

Markdown is simpler to read, write, and edit than HTML. It version-controls cleanly in Git and is supported natively by GitHub, GitLab, Notion, Obsidian, Slack, and most documentation platforms. Converting existing web content to Markdown lets you work with it in a more portable format.

What HTML elements cannot be converted to Markdown?

Elements with no Markdown equivalent are dropped or approximated: inline CSS styles, class/ID attributes, form inputs, iframes, canvas, video, audio, and structural divs/spans. Tables convert to GFM pipe syntax but complex merged cells are not supported.

Does the conversion preserve links and images?

Yes. <a href="url">text</a> becomes [text](url) and <img src="url" alt="text"> becomes ![text](url). Relative URLs are preserved as-is; if you need absolute URLs, update the base URL first.

How do I convert a full webpage to Markdown?

View page source (Ctrl+U), copy the HTML of the main content area (not the full page), and paste it here. Alternatively, use browser extensions like "Copy as Markdown" for a one-click workflow.

How do I convert HTML to Markdown in Python?

Use the markdownify library: pip install markdownify then from markdownify import markdownify as md; result = md(html_string). For more control, pandoc is the most capable tool: pandoc -f html -t markdown input.html -o output.md.