What is HTML to Markdown conversion?
Converting HTML to Markdown is useful when you want to move content from a CMS or web page into a Markdown-based system like GitHub, GitLab, Notion, or a static site generator. The conversion strips HTML tags and replaces structural elements with Markdown equivalents: <h1> becomes #, <strong> becomes **, <a href> becomes [text](url), and so on. This tool uses the Turndown library with optional GitHub Flavored Markdown (GFM) support for tables and strikethrough.
How to use this tool
- 1 Paste your HTML into the Input panel — conversion happens live.
- 2 Enable "GFM" to output GitHub Flavored Markdown (tables, strikethrough) instead of standard Markdown.
- 3 Enable "Fenced code blocks" to use ``` fences instead of indentation for code.
- 4 Copy the Markdown output and paste it into your target editor.
Frequently asked questions
Will all HTML convert perfectly to Markdown?
Most semantic HTML converts cleanly, but Markdown is less expressive than HTML. Complex CSS layouts, inline styles, SVGs, iframes, and custom elements cannot be represented in Markdown and are dropped or approximated.
What is GitHub Flavored Markdown (GFM)?
GFM extends standard Markdown with tables (| column | column |), task lists (- [ ]), strikethrough (~~text~~), and fenced code blocks with language hints. These extensions are supported by GitHub, GitLab, and many modern editors.
Does it convert HTML tables?
Yes, if GFM is enabled. HTML tables become Markdown pipe tables. Standard Markdown has no table syntax, so without GFM tables are converted to a list or dropped.
Is my HTML uploaded to a server?
No. The Turndown library runs entirely in your browser via CDN. Your HTML never leaves your machine.
What library powers this tool?
Turndown (v7) with the turndown-plugin-gfm extension for GitHub Flavored Markdown support — both loaded from the jsDelivr CDN on first use.