About html to markdown converter
Convert HTML into clean Markdown, keeping headings, links, images, lists and tables.
When it helps
- Moving blog posts into a static site or docs system.
- Cleaning up content copied from a web page.
- Writing README files from HTML.
Limits
Layout, CSS and scripts do not exist in Markdown. Complex HTML may need tidying by hand.
A worked example
<h2>Setup</h2><p>Run <code>npm install</code>.</p> becomes '## Setup' followed by 'Run `npm install`.' Links, images, ordered and unordered lists and simple tables convert cleanly. Inline styles and layout wrappers are dropped.
Cleaning up afterwards
- Check heading levels, since a page may have used the wrong ones.
- Fix images that point to relative paths on the old site.
- Remove leftover navigation and footer text if you pasted a whole page.
Tables
Simple tables become Markdown tables, but tables with merged cells or nested content stay as HTML or lose structure. Review them by eye.
