About this tool
Convert copied HTML fragments into readable Markdown when moving content into README files, docs, changelogs, CMS editors, or issue comments.
HTML to Markdown Converter helps when content needs to move from web markup into README files, docs, changelogs, CMS markdown fields, issue comments, or static-site content. It focuses on readable Markdown output for common article and documentation tags rather than preserving every browser-specific detail.
- Uses Turndown 7.2.4 and the GFM 1.0.2 plugin for headings, emphasis, links, images, nested lists, task lists, strikethrough, code, blockquotes, and basic tables.
- Removes script, style, noscript, and template content, blocks unsafe URL schemes by default, and preserves tables with spans or nesting as raw HTML.
- Controls heading, bullet, code fence, link, and GFM policies and enforces input, parsed-node, depth, and output bounds locally.
How to use HTML to Markdown
Paste an HTML fragment, review the generated Markdown, and copy it into the destination editor after checking links, lists, code blocks, and tables. For complex CMS exports, convert a short sample first so custom embeds, scripts, styles, and table structures can be reviewed before the full migration.
When this tool is useful
- When moving HTML article snippets into Markdown-based docs, README files, or static-site content.
- Before cleaning CMS exports that include headings, links, lists, code, blockquotes, or basic tables.
- When support, product, or engineering notes need to be converted into Markdown issue comments.
Practical tips
- Preview the converted Markdown in the destination platform because Markdown flavors differ.
- Review complex tables, nested lists, custom embeds, and shortcodes manually after conversion.
- Remove tracking wrappers, scripts, styles, and unrelated layout markup before publishing migrated content.
Examples you can test
Load an example, compare the result with the expected output, then replace it with your own input.
Convert article HTML to Markdown
Example input
<h2>Setup</h2><p>Run <strong>npm install</strong> first.</p>
Expected output
## Setup Run **npm install** first.
Useful when moving help docs, changelogs, or blog fragments into Markdown-first systems.
Convert a linked checklist
Example input
<ul><li><a href="/privacy">Review privacy page</a></li><li>Check sitemap</li></ul>
Expected output
- [Review privacy page](/privacy) - Check sitemap
List and link conversion makes copied CMS content easier to reuse in GitHub issues or README files.
Validation checklist
- Preview the converted Markdown in the final platform before publishing.
- Check links, images, code blocks, tables, and nested lists after conversion.
- Remove scripts, styles, tracking wrappers, or layout-only markup before migration.
- Review complex tables manually because Markdown table support is limited.
- Keep alt text on images when moving converted content into public docs.