HTML to Markdown Converter, Tables Included

What this HTML to Markdown converter does

The converter parses your HTML in the browser and rewrites it as Markdown with Turndown 7.2 and the turndown-plugin-gfm 1.0.2 extension. Headings, paragraphs, emphasis, links, images, lists, blockquotes and code blocks map to standard Markdown; tables, strikethrough and task lists use GitHub Flavored Markdown (GFM) syntax. <script>, <style>, <noscript>, <template> and <title> elements are removed together with their content.

HTML can express far more than Markdown can. There is no Markdown for colours, classes, underlining, column spans or most layout, so the converter keeps the text of such elements and drops the markup. That trade-off is the point: you get plain, portable text with its structure intact.

How to use the converter

1. Paste HTML into the HTML Input pane — a fragment or a whole page — or load it with File or URL. A URL only loads when the server allows cross-origin requests, which most websites do not; saving the page and using File is usually easier.
2. Click Convert. Unlike the Markdown to HTML page there is no live update, so convert again after editing or loading a file.
3. Copy the result, Download it as converted.md, or Clear both panes.

Output style

The converter is set up with ATX headings (## Heading), fenced code blocks and - as the bullet marker. The other choices are Turndown’s defaults:

Characters that would otherwise be read as Markdown are escaped with a backslash: 1. Not a list becomes 1\. Not a list, and * and _ in text become \* and \_. Entities are decoded, so © becomes © and   becomes a non-breaking space character.

Example

<h1>Install</h1>
<p>Run <code>npm i</code>, then <strong>restart</strong> the <em>server</em>.</p>
<ul><li>One</li><li>Two<ul><li>Nested</li></ul></li></ul>

converts to:

# Install

Run `npm i`, then **restart** the _server_.

-   One
-   Two
    -   Nested

Converting an HTML table to a Markdown table

Paste the table on its own or inside a whole page: every table whose first row is a header becomes a GitHub-flavoured Markdown (GFM) pipe table, the format GitHub, GitLab, most static site generators and many note-taking apps render. Links, bold text and code inside cells are converted too, and align="right" becomes --: in the separator row.

<table>
  <thead><tr><th>Format</th><th>Typical use</th><th align="right">Size</th></tr></thead>
  <tbody>
    <tr><td><strong>JSON</strong></td><td>APIs and config</td><td align="right">small</td></tr>
    <tr><td>CSV</td><td>Spreadsheets and exports</td><td align="right">smaller</td></tr>
  </tbody>
</table>

converts to:

| Format | Typical use | Size |
| --- | --- | --: |
| **JSON** | APIs and config | small |
| CSV | Spreadsheets and exports | smaller |

The header row is required because a Markdown table cannot exist without one. If your table has none, make the first row <th> cells before converting, or keep the table as HTML, which most Markdown renderers display as it is. Merged cells (colspan and rowspan) have no Markdown equivalent either, so such a table is best kept as HTML. A pipe character (|) inside a cell is written as \|, so it stays in its cell instead of starting a new column. To go the other way, from spreadsheet cells to HTML, use the HTML table generator.

Common problems and fixes

Frequently asked questions

Related tools