HTML to Markdown
HTML to Markdown Converter
Paste HTML or drop an .html file — get clean GitHub Flavored Markdown instantly. Nothing is uploaded.
- Runs in your browser
- Nothing uploaded
- No sign-up
- Free, no daily limits
- 1Add your file
- 2Choose settings
- 3Download
100% Private: conversion runs entirely in your browser. Your HTML never leaves your device — nothing is uploaded, stored, or logged.
Convert HTML to Markdown Online: Free and Fast
HTML to Markdown is a free in-browser converter that translates web markup into clean GitHub Flavored Markdown without uploading files to remote servers. Paste HTML or drop an .html file. The parser turns HTML tables into GFM pipe tables, preserves code fences, strips Word and Google Docs style soup, and outputs standard Markdown ready for documentation sites, Obsidian, or GitHub README files.
Last updated .
Real Conversion Sample: GFM Tables and Code Fences
Here is how semantic HTML markup transforms into clean Markdown. Notice how tables gain alignment dividers, task checkboxes remain intact, and code blocks retain their syntax tags:
<h1>Release Notes v2.4</h1>
<table>
<thead>
<tr><th>Task ID</th><th>Component</th></tr>
</thead>
<tbody>
<tr><td>ENG-401</td><td>Parser core</td></tr>
</tbody>
</table>
<pre><code class="language-typescript">
const status = "ok";
</code></pre># Release Notes v2.4 | Task ID | Component | | --- | --- | | ENG-401 | Parser core | ```typescript const status = "ok"; ```
Edge Cases We Handle (And How)
| Input Quirk | What Our Parser Does | Code Location & Rule |
|---|---|---|
| Word and Google Docs HTML | Pre-cleans mso comments, Office XML tags, and fake bold wrappers before Turndown parses. | lib/markdown-convert.ts:145-153 (cleanHtmlForMd) |
| Embedded scripts and styles | Removes script, style, head, meta, link, and noscript elements entirely from the DOM tree. | lib/markdown-convert.ts:179 (td.remove) |
| HTML table elements | Converts tables into GFM pipe tables with aligned header delimiters via turndown-plugin-gfm. | lib/markdown-convert.ts:178 (td.use gfm) |
| Non-breaking spaces ( ) | Normalizes \u00a0 characters to standard spaces so code indentation does not break. | lib/markdown-convert.ts:206 |
| Nested list indentation | Replaces 4-space Turndown defaults with tight list markers matching modern Markdown style. | lib/markdown-convert.ts:183-200 (tightListItem) |
| Inline CSS font and color styles | Discards non-semantic styling like color:red while preserving true structural elements. | lib/markdown-convert.ts:168-177 |
How to Convert HTML to Markdown Step-by-Step
Add HTML Content
Paste markup or drop an .html file. Entire documents are supported; head blocks are stripped automatically.
Inspect Live Markdown
Clean GitHub Flavored Markdown renders instantly as text updates in the editor.
Customize Syntax Rules
Select ATX or Setext headings, bullet characters, and fenced or indented code blocks.
Copy or Download
Copy clean Markdown directly or download a ready-to-commit .md file.
Key Capabilities of TryDocsy's HTML to Markdown Tool
Tables and Lists Preserved
HTML tables become GFM pipe tables; nested lists retain their exact hierarchy and marker indentation.
Granular Style Options
Choose ATX (#) or Setext headings, custom bullet characters, and inline or reference link formatting.
Word and Docs Sanitization
Removes mso styles, Office tags, XML junk, and Google Docs wrapper markup automatically.
Code Syntax Preservation
Pre/code blocks convert to fenced code blocks and retain their language tags for syntax highlighting.
Instant In-Memory Conversion
Markdown updates on every keystroke without server requests, watermarks, or daily file limits.
Client-Side Privacy
Scripts and styles are stripped before parsing. Everything runs in your browser without data uploads.
When Not to Use This Web Tool
This browser converter does not scrape or fetch live web URLs; you must paste your HTML markup directly or open a saved .html file. Colors, font families, and pixel-positioned layouts have no equivalent in plain Markdown. For bulk CLI processing across large repositories, command-line tools like pandoc -f html -t gfm input.html -o output.md are better suited.
Frequently Asked Questions
How do I convert HTML to Markdown in my browser?
Paste your raw HTML or drop an .html file into the editor. The tool compiles your markup into clean GitHub Flavored Markdown on a debounced keystroke timer. You can copy the result directly to your clipboard or download a ready-to-commit .md file.
What happens to HTML tables, images, and nested lists?
HTML tables convert to standard GFM pipe tables with aligned header delimiters. Images preserve their alt text and source URLs. Nested lists, blockquotes, hyperlinks, and code blocks retain their indentation and structure.
How does the converter clean up HTML copied from Word or Google Docs?
Our pre-cleaning pipeline strips MSO conditional comments, Office namespace tags (o:, w:, m:, v:), and Google Docs wrapper elements. It removes bloated inline styles while preserving semantic bold, italic, headings, and lists.
Are scripts, styles, and comments removed from the output?
Yes. The parser removes script, style, head, title, meta, link, noscript, and template elements, along with all HTML comments. Only meaningful readable content translates into Markdown.
Can I customize heading, bullet, and code block styles?
Yes. You can switch between ATX (#) and Setext (===) headings, choose hyphen (-), asterisk (*), or plus (+) list bullets, toggle between fenced and indented code blocks, and select inline or reference link formats.
What is the maximum file size for in-browser conversion?
The tool processes HTML documents up to 25 MB in browser memory. For bulk site migrations involving thousands of HTML pages, command-line converters like Pandoc offer faster batch execution.