OnboxTools
Local processingNo uploadFree
Report bug

Convert HTML to markdown online

Free HTML to markdown converter for migration and cleanup

Paste HTML and get clean markdown output — headings, lists, links, and paragraphs mapped with Turndown rules. Built for migrating blog posts, CMS exports, and email HTML into markdown files for git-based docs.

HTML input
Markdown output
DirectionHTML → MD
Output words
Output size
StatusIdle

Complete guide to HTML to markdown conversion online

What an HTML to markdown converter does

An HTML to markdown converter walks a DOM tree and emits equivalent markdown syntax: h1 tags become # headings, strong becomes **bold**, anchors become [text](url) links, and list structures become bullet or numbered markdown lists.

The process is inherently lossy. CSS classes, inline styles, data attributes, and complex layout components do not have standard markdown representations. Expect to hand-edit edge cases after bulk migration.

This html to md tool uses Turndown with ATX headings and fenced code blocks — a common default for documentation repos and static site generators that ingest markdown files.

Because conversion is client-side, proprietary HTML from internal tools never uploads during migration drafts.

How to convert HTML to markdown online

Paste HTML into the input panel — full documents or fragments both work. Markdown output updates live. Import .html or .htm files when migrating archived exports.

Copy markdown to your clipboard or download converted.md for commit into a git repository. Review code fences and image syntax before merging pull requests.

Strip script tags and tracking pixels from source HTML before conversion when migrating public blog content. Turndown ignores many non-content nodes, but cleaning upstream reduces noise in output.

For forward conversion after editing markdown, open Markdown to HTML. For visual preview of markdown source, use Markdown Preview.

When HTML to markdown works well

Simple articles with headings, paragraphs, emphasis, links, and unordered lists convert cleanly — ideal for moving Medium exports or old WordPress HTML into a docs repo.

Technical documentation with fenced code in pre tags usually maps to triple-backtick blocks. Verify language tags manually if your site relies on them for syntax highlighting.

Tables may become pipe tables or simplified text depending on complexity. Complex colspan layouts often need reconstruction by hand.

Nested navigation menus and widget sidebars should be removed from HTML before conversion so Turndown focuses on article body content.

When conversion needs manual cleanup

Custom components — callouts, tabs, embedded widgets — rarely have markdown equivalents. Replace them with plain blockquotes or HTML blocks your target platform allows.

Inline styles that encode semantics (color for warnings) are lost. Reapply meaning with markdown blockquote syntax or platform-specific extensions after migration.

Footnotes, definition lists, and figure captions may flatten into plain paragraphs. Compare against the source HTML when accuracy matters for legal or spec documents.

Always spot-check link URLs and image paths. Relative links that worked on the old site may need updating for the new host.

HTML to markdown vs WYSIWYG editors

WYSIWYG editors export unpredictable HTML full of span wrappers. Paste through this converter, then simplify markdown in a text editor for cleaner git diffs.

Some CMS platforms offer native HTML-to-markdown plugins. A browser converter helps when you lack admin access or need a quick one-off migration on a locked-down laptop.

Pair conversion with Find and Replace when the same CSS class name appears hundreds of times in exported HTML before you paste.

Markdown files age better in version control than HTML blobs — smaller diffs, readable blame, and portable tooling.

Migrating a simple blog post

Copy article HTML from view-source or CMS export, paste into the converter, and save markdown into your docs repo.

Remove nav, footer, and comment widgets from the HTML first so output contains only post body content.

Cleaning CMS export noise

Run bulk find-and-replace on class-heavy span tags in the HTML export when possible, then convert.

Reinsert images with standard markdown image syntax if Turndown emits bare URLs without alt text.

HTML to Markdown FAQ

Is HTML to markdown conversion lossless?

No. Styles, classes, and complex layouts do not map to markdown. Manual cleanup is normal for non-trivial pages.

Does this tool upload my HTML?

No. Turndown runs in your browser. Source HTML never leaves your device.

Can I convert full HTML documents?

Yes. Paste complete pages or fragments. Remove nav and footer markup first for cleaner article-focused markdown.

How do I convert markdown back to HTML?

Use our Markdown to HTML tool for forward conversion with the marked parser.

Why are my tables simplified?

Complex tables with colspan or nested elements often flatten. Rebuild pipe tables manually in markdown when needed.

Are script tags included in markdown output?

Turndown typically drops scripts. Still remove untrusted script tags from source HTML before migration.

Does the HTML to Markdown send my input to a server?

Yes. Everything runs in your browser. Your input is not uploaded, logged, or stored on our servers.

Do I need an account?

No account or sign-up is required. Open the page and start using the tool immediately.