How it works
The HTML to Markdown Converter transforms HTML markup back into clean, readable Markdown syntax. It is the inverse of Markdown to HTML — useful when you need to extract content from an HTML page and work with it in a Markdown-native tool.
Use cases arise constantly: copying content from a website into a Notion page, Obsidian vault, or GitHub issue; extracting article content from HTML for editing in a Markdown editor; converting HTML documentation to a static site format; and preserving formatting when pasting from rich text editors that export HTML.
How to use it: paste HTML source code (a full page, a fragment, or just the body content). The converter strips tags and translates HTML elements to their Markdown equivalents: <h1>–<h6> → # headings, <strong>/<b> → **bold**, <em>/<i> → *italic*, <a href="..."> → [text](url), <ul>/<li> → - bullet, <code> → `backtick code`, <pre> → fenced code block.
What doesn't convert cleanly: complex nested tables, span-level styling (color, font-size), SVG and Canvas elements, and custom CSS classes. These are either dropped or converted to plain text with a note. HTML forms are not converted.
Output quality: the Markdown output is clean, readable, and compatible with GitHub Flavored Markdown (GFM), CommonMark, and most static site generators.
Frequently Asked Questions
- Yes. Paste the full HTML source including <html>, <head>, and <body> tags. The converter processes only the <body> content and ignores scripts, styles, and meta tags.
- HTML tables are converted to GFM Markdown table syntax (using pipe characters). Complex tables with merged cells (colspan, rowspan) are converted to plain text with a note that the merge was lost.
- Inline styles (color, font-size), SVG elements, Canvas, iframes, forms, and custom/unknown elements are either stripped or converted to plain text. Only semantic HTML with Markdown equivalents is fully converted.
- Output targets GitHub Flavored Markdown (GFM), which is supported by GitHub, GitLab, Notion, Obsidian, and most major Markdown platforms.