Skip to content

HTML to Markdown Converter

Paste an HTML fragment or a saved web page and get clean Markdown with the style options you prefer.

Processed locally in your browser

Options
0 chars · 0 lines
The result will appear here.

What is HTML to Markdown Converter?

HTML to Markdown conversion is handy when you migrate content from a CMS, a blog or an email into a Markdown-based system such as a static site generator, wiki or documentation repository.

The converter first sanitizes your HTML with DOMPurify, so scripts, styles and event handlers are dropped, then maps the remaining tags to Markdown with Turndown. GitHub-flavoured extras are added by dedicated rules: tables with column alignment, ~~strikethrough~~ and - [x] task lists. You choose ATX or Setext headings, the bullet character, fenced or indented code and inline or reference links.

How does it work?

  1. Paste an HTML fragment or the whole page source in the input box.
  2. Pick heading style, bullet marker, code block style, link style and emphasis delimiter.
  3. Keep the GFM option on to convert tables, strikethrough and task lists; turn it off for plain CommonMark.
  4. Copy or download the Markdown and check the rendered preview underneath.

Common use cases

  • Migrating blog posts or help-center articles to a static site generator.
  • Turning an HTML email or newsletter into editable Markdown notes.
  • Extracting readable documentation from copied web page markup.
  • Converting HTML tables into Markdown tables for a README.

Examples

Try this input in the tool above:

<h1>Product update</h1>
<p>This release adds <strong>dark mode</strong>, <em>faster search</em> and <del>legacy exports</del>.</p>
<h2>What changed</h2>
<ul>
  <li>New <a href="https://example.com/changelog" title="Changelog">changelog page</a></li>
  <li>Keyboard shortcuts</li>
  <li><input type="checkbox" checked disabled> Accessibility review</li>
  <li><input type="checkbox" disabled> Translations</li>
</ul>
<ol><li>Update the app</li><li>Restart it</li></ol>
<table>
  <thead><tr><th>Plan</th><th align="right">Seats</th></tr></thead>
  <tbody>
    <tr><td>Free</td><td align="right">1</td></tr>
    <tr><td>Team</td><td align="right">25</td></tr>
  </tbody>
</table>
<blockquote><p>Simple i
…

Privacy

HTML to Markdown Converter runs entirely in your browser. The text or files you provide are processed on your device and are not uploaded, logged or stored on our servers.

Limitations

Markdown cannot express everything HTML can: layout, inline styles, forms, scripts and iframes are dropped, and complex tables (merged cells) are flattened. Review the result before publishing.

Frequently asked questions

Are scripts or styles in my HTML kept?

No. The input is sanitized first and turndown additionally removes script, style and noscript, so only content markup reaches the Markdown.

How are HTML tables converted?

With GFM enabled, the first row becomes the header, cells are separated by pipes and the align attribute of th/td controls the :---: markers. Pipes inside cells are escaped.

What is the difference between ATX and Setext headings?

ATX uses leading # characters (# Title). Setext underlines the text with === or ---, and only exists for levels 1 and 2; other levels still use #.

More tools in Markdown & Diagrams →