HTML to Markdown Converter
Data ConversionConvert HTML content into Markdown syntax.
Discussion
Join the discussion
Sign in to share your thoughts and engage with the community.
About this tool
What is the HTML to Markdown Converter?
Markdown is a lightweight plain-text format that renders into HTML — it's the standard for README files, documentation sites, static site generators, and many content management systems. HTML, meanwhile, is what browsers render and what rich text editors, email clients, and web scrapers produce.
The HTML to Markdown Converter translates in the other direction: from HTML to Markdown. Paste raw HTML and get clean, readable Markdown syntax — ready to drop into a documentation file, a CMS, or a code repository.
How to Use the Converter
- Paste your HTML into the input field. This can be a full HTML document, a
<body>fragment, a copied webpage section, or the raw HTML output of a rich text editor. - Convert. The tool parses the HTML structure and maps each element to its Markdown equivalent.
- Review the output. The Markdown appears in the result panel, formatted and ready to use.
- Copy the Markdown and paste it wherever you need it.
HTML to Markdown Conversion Reference
The converter handles all standard HTML elements that have direct Markdown equivalents:
Headings — <h1> through <h6> become # through ######
Text formatting — <strong> and <b> become **bold**, <em> and <i> become *italic*, <code> becomes `inline code`
Links — <a href="url">text</a> becomes [text](url)
Images — <img src="url" alt="text"> becomes 
Lists — <ul> with <li> items becomes a - unordered list; <ol> becomes a numbered list
Code blocks — <pre><code> blocks become fenced code blocks with triple backticks
Blockquotes — <blockquote> becomes > prefixed lines
Horizontal rules — <hr> becomes ---
Tables — <table> elements are converted to GitHub Flavored Markdown (GFM) table syntax where supported
Common Use Cases
Migrating content to a static site generator — static site tools like Hugo, Jekyll, and Astro work natively with Markdown. If your existing content is in HTML (exported from WordPress, Drupal, or another CMS), this tool converts it to the format these generators expect.
Documentation writing — technical documentation is frequently written in Markdown for GitHub, GitLab, or documentation platforms like Docusaurus and MkDocs. Converting existing HTML docs saves manual reformatting.
Processing scraped or copied content — when content copied from a browser or fetched by a scraper comes in as HTML, converting it to Markdown gives you a cleaner, portable plain-text version.
Rich text editor output — many WYSIWYG editors output raw HTML. If you need to store or display that content as Markdown (for a Markdown-first CMS or documentation tool), this converter handles the translation.
README and wiki files — GitHub README files and wikis use Markdown. If you have existing HTML documentation to port over, convert it in one step rather than rewriting it by hand.
Limitations
HTML elements without a Markdown equivalent — custom CSS classes, <div> containers, <span> tags, inline styles, and JavaScript — are either stripped or passed through as raw HTML. Markdown is a subset of what HTML can express, so some presentation details will be lost in conversion.
Privacy
All HTML parsing and Markdown conversion happens in your browser. No content is sent to any server or stored anywhere.