April 4, 2026 · Updated April 4, 2026 · 6 min read
How to Convert HTML to Markdown (and Vice Versa)
A practical guide to converting HTML to Markdown and back - covering edge cases formatting preservation and the best free browser-based tools.
The web runs on HTML. Markdown makes that content human-writable. Converting between the two is common whether you are migrating a docs site pulling content from a CMS or converting notes to a blog post. Neither direction is a perfect round-trip - understanding why saves hours of frustration.
HTML to Markdown: what translates cleanly
Semantic HTML converts reliably: headings paragraphs lists blockquotes code links images. The tricky parts are div layouts inline styles merged-cell tables and custom components.
- Headings to # syntax
- Paragraphs to blank-line-separated blocks
- Lists to - or 1. syntax
- Code blocks to triple backticks
- Tables to pipe syntax
- Links to [text](url) syntax
Try it yourself
HTML to Markdown Converter
Paste HTML, get clean Markdown instantly. Tables, code, and links preserved.
Open ToolMarkdown to HTML: what to watch for
Markdown to HTML is usually cleaner since Markdown is a constrained format. Issues arise with custom parser extensions link formatting and image sizing.
When browser-based conversion makes sense
For one-off migrations - a legacy blog post docs page product description - browser-based HTML to Markdown is fastest. You paste you convert you copy.
Round-trip quality: how to preserve intent
- Audit source HTML for colspan rowspan
- Remove inline styles before conversion
- Test the output by converting back to HTML
- Fix image src paths for relative URLs
- Normalize heading hierarchy after conversion
FAQ
Does HTML to Markdown conversion preserve tables?
Simple tables with clean column structure convert well. Merged cells and layout divs usually need manual cleanup.
How do I convert HTML to Markdown for free?
Browser-based tools paste and convert instantly without uploading. Content stays on your device throughout.
Can I convert Markdown back to HTML automatically?
Yes. Most Markdown parsers output standard HTML. Use GFM-compatible parsers to preserve tables task lists and strikethrough.