100% local processing — your files and data never leave this browser. No uploads, no server storage.

OnboxTools

Free · Browser-only · No upload

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.

Conversion runs entirely in your browser with no upload. Copy the result, download a .md file, or switch to Markdown to HTML when you need the forward direction.

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

More Text Utilities

🔓
Base64 Decoder
🧬
Base64 Encoder
🔡
Case Converter
Cron Generator
🎨
CSS Minifier
📐
CSS Unminifier
📆
Date Format Converter
📅
Date to Unix
🔎
Find and Replace
🛡️
HTML Escape
📰
HTML Minifier
↩️
HTML to Markdown
🔓
HTML Unescape
📄
HTML Unminifier
📋
Markdown Preview
🔄
Markdown to HTML
🎲
Random Number
🔤
Random String
🔍
Regex Tester
🧹
Remove All Whitespace
↩️
Reverse Text
✂️
Split String
⚖️
Text Compare
🔁
Text Repeater
📖
Text Viewer
🌍
Time Zone Converter
🕐
Unix Time to Date
🔗
URL Encoder
🔤
UTF-8 Decoder
🌐
UTF-8 Encoder
📊
Word Counter

Browse by category

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.

Privacy and related tools

Turndown runs locally. HTML snippets from staging sites or customer portals are not sent to a server.

Use Markdown to HTML for the reverse path. Use Markdown Preview to validate recovered markdown renders as expected before deleting legacy HTML archives.

Clear the textarea on shared machines after processing confidential HTML exports.

Detailed guide

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.

Common questions

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.