HTML to Markdown converter
Turn an HTML page into readable Markdown, dropping scripts and styles.
Processed in your browser. This file is converted on your device and is never uploaded.
Converter
.html, .htm up to 25 MB. You can also drag a file here.
No file selected.
About this tool
Moving content out of a CMS, a saved web page, or an HTML email into a repository, wiki, or notes application usually means turning it into Markdown first. This tool converts an HTML file into readable Markdown.
Scripts and stylesheets are removed rather than transcribed, since neither carries prose.
Supported formats and limits
- Input
- .html, .htm
- Output
- .md (text/markdown)
- Output name
- The original name with the new extension, for example data.html becomes data.md.
- File size limit
- 25 MB
- Processing
- In your browser. The file is not uploaded.
HTML against Markdown
| Feature | HTML | Markdown |
|---|---|---|
| Stored as | Plain text, readable in any editor | Plain text, readable in any editor |
| What it can hold | Prose with markup around it | Prose with markup around it |
| Numbers stay numbers | No | No |
| Comments | Yes | No |
| Several in one file | No | No |
| Published | 1993 | 2004 |
How to use it
- Choose an .html or .htm file, or switch to Paste text and paste the markup directly.
- Pick the bullet character you prefer for lists.
- Select Convert, then download the .md file.
Limitations
- Markdown is a much smaller language than HTML. Anything without an equivalent, including classes, inline styles, data attributes, and layout containers, is dropped.
- Complex tables, especially ones using colspan or rowspan, do not survive; Markdown tables are strictly rectangular.
- Forms, iframes, videos, and embedded widgets are not represented.
- Whitespace-sensitive markup can shift, so preformatted blocks are worth checking.
- The conversion is one-way. Running the result back through the Markdown to HTML tool will not reproduce your original markup.
Common problems
The file was refused before anything started.
HTML to Markdown converter checks the extension before it reads a byte, and it accepts .html, .htm. Browsers report file types inconsistently enough that the extension is what decides.
Rename the file if the extension is simply wrong, or convert it to one of those first. A file whose extension does not match its contents is refused for the same reason, and that one needs converting rather than renaming.
It said the file was too large.
The limit here is 25 MB. It is not a policy but a measurement: everything runs on your own device, and past that size a phone runs out of memory rather than finishing slowly.
Split the file, reduce it before converting, or use a desktop program for that one. A machine with more memory will manage more, but the limit does not know which machine it is on.
I selected several files and only one converted.
This tool takes one file at a time. Doing several at once would multiply the memory in use, which is the thing most likely to fail on a phone.
Convert them one after another. Nothing is kept between them, so there is no state to reset.
The tab reloaded itself part-way through.
The browser ran out of memory and restarted the page. At sizes approaching 25 MB this is the failure a phone hits first, and it looks like a crash rather than an error.
Try a smaller file, close other tabs, or run it on a computer. Nothing was uploaded or lost — the original file is untouched on your device.
The result opened in the wrong program.
The output is a .md file, and your system opens that extension with whatever it was told to. Nothing about the conversion decides it.
Open it from inside the program you want, or change the default for .md in your system settings. The file itself is correct.
Frequently asked questions
- Is my file uploaded?
- No. The conversion runs entirely in your browser. The file never leaves your device and no request carrying its contents is made.
- What happened to my styling?
- Markdown has no concept of styling. Headings, lists, links, emphasis, and code are preserved as structure; visual presentation is not.
- Can I convert a whole saved web page?
- Yes, though navigation, footers, and sidebars will be converted alongside the article. Trimming the markup to the content you want first gives a much cleaner result.
- Is inline HTML kept?
- Elements with no Markdown equivalent are left as inline HTML, which is valid inside a Markdown document. Scripts and styles are removed.
- Do I need to install anything or create an account to use HTML to Markdown converter?
- No, to all of it. HTML to Markdown converter runs inside the browser you already have, with no sign-up, no download, no watermark on the result, and no cap on how many files you convert. There is nothing to uninstall afterwards either, because nothing was installed.
- Does HTML to Markdown converter work offline?
- Once the page has loaded, yes. The conversion runs on your device, so it needs no connection to do the work. The first visit fetches the page and the code that does the converting; after that a lost connection stops nothing, and a converted file appears exactly as it would online.
- How large a file can HTML to Markdown converter handle?
- The limit is 25 MB. It is a deliberate one rather than a technical ceiling: the real constraint is memory, and a file that decodes to more than the device can hold fails in a way that is hard to explain. Phones run out well before laptops do, which is why the limit is set where it is.
- Can I convert several files at once with HTML to Markdown converter?
- Not here: this tool takes one file at a time, because what it does depends on choices you make about that particular file. Convert them one after another, or look at the batch converters in the same category, which are built for a folder at a time.