How to convert HTML to Markdown
Short answer
Paste the HTML into a converter and it maps tags to Markdown — headings, links, lists, bold, and code. Structural HTML converts cleanly; complex layout, tables, and inline styles may need a quick manual tidy.
Why convert to Markdown
Markdown is portable, diff-friendly, and readable as plain text, so it is ideal for docs, notes, README files, and static sites. Converting HTML from a page, a rich-text editor, or AI output to Markdown gives you clean source you can version and reuse. See what is Markdown.
Convert the HTML
- Paste the HTMLDrop in the markup from a page, email, or editor.
- Read the Markdown outputTags map to their Markdown equivalents automatically.
- Tidy the edgesCheck tables, nested lists, and anything with inline styles.
div-based layout, and inline CSS have no Markdown equivalent, so they are simplified or dropped.Round-tripping
Markdown and HTML convert both ways, but the trip is lossy for anything without a Markdown equivalent. Keep the Markdown as your source of truth and generate HTML from it — see Markdown vs HTML.