Upload saved HTML, not a URL
The public converter does not fetch remote pages. Save or export the HTML you are authorized to process, then upload that file.
HTML conversion
Reduce semantic HTML to portable Markdown
HTML can describe everything from a focused article to an entire application shell. Markdown intentionally has a smaller vocabulary. Conversion works best on saved, content-oriented HTML and produces a draft that is easier to diff, version, and move between documentation tools.
Supported extensions: .html, .htm. Files are processed temporarily and are not placed in public URLs.
Best fit
Structure-first conversion
Saved articles, documentation pages, release notes, README migrations, and semantic HTML fragments that do not depend on client-side rendering.
1Upload
2Convert
3Edit
Useful structure
What the conversion aims to preserve
- Semantic headings, paragraphs, blockquotes, and lists
- Links, emphasis, inline code, and conventional code blocks
- Simple tables and image references
- Document title and readable text present in the uploaded HTML source
Manual review
Where cleanup may be needed
- CSS layout, colors, responsive behavior, and visual spacing are not Markdown concepts
- JavaScript-rendered content is unavailable when it is absent from the saved source
- Navigation, cookie banners, sidebars, and other boilerplate may need removal
- Custom components, forms, embeds, and interactive widgets do not have direct Markdown equivalents
Small example
From HTML content to Markdown source
Semantic elements translate cleanly; presentation CSS is deliberately left behind.
A semantic HTML fragment
<article><h1>API status</h1><p>All systems <strong>operational</strong>.</p><a href="/history">History</a></article>
result.mdeditable
# API status All systems **operational**. [History](/history)
Better input, cleaner output
HTML conversion tips
Prefer the article fragment
Removing site navigation and page chrome before conversion reduces repetitive cleanup.
Check relative links
A link such as /docs/setup depends on its original site. Replace it with an absolute or repository-appropriate destination when needed.
For a repeatable review process, read the conversion best-practices guide and the guide to cleaning converted Markdown.
HTML to Markdown FAQ
Practical answers about what the conversion does—and what still deserves a human review.
Can I paste a website URL for conversion?
No. The public endpoint accepts uploaded files only and does not perform remote URL conversion. This keeps the conversion boundary narrower and more private.
Will CSS and page layout be preserved?
No. Markdown carries content hierarchy rather than presentation rules. CSS, responsive layouts, and interactive behaviors are omitted.
Is converted HTML safe to preview?
Converted content is treated as untrusted, and the editor preview sanitizes rendered output. You should still review external links and embedded references before publishing.
Related workflows
Explore other supported formats
Make the next draft easier to edit
Upload a supported HTML file, convert it privately, and continue in the Markdown editor without exposing its contents in the URL.
Convert HTML to Markdown