HTML to Markdown Converter

Turn headings, lists, and links into Markdown.

Use this tool

Result

The result appears in this panel after you run the tool.

About this tool

Scripts are not kept. The conversion is a local HTML-to-Markdown pass.

Complex tables and custom elements may become plain text.

How to use it

  1. Open this page and provide the input it asks for.
  2. Set the options that are visible, then use Convert to Markdown.
  3. Read the result in the panel. Copy it or download it when a file is offered. The input stays in this browser.

Limitations

Default Turndown rules, with the grid left behind

The conversion follows Turndown’s built-in rules

Turndown walks the markup with its default rules. The page constructs that converter with no extra plugin and no custom rule set. Headings, emphasis, links, images, lists, and code that those default rules know are written as markdown. A class attribute, an id, and an inline style do not have a markdown spelling in those rules, so they are dropped. Event-handler attributes are not kept as markdown. The result is markdown text, not a second HTML document.

Tables are the structural mismatch to plan for. The default converter on this page does not include a table plugin, so a grid is not written as a markdown table. Cell text may survive in a flattened form, and the rows and columns will not. If the table was the content, do not expect to rebuild it from the markdown. Definition lists, ruby annotations, and other markup outside the default rules are similarly reduced to whatever those rules emit, often plain text or nothing.

Scripts are not a markdown feature

A script element’s program is not a sentence you want in the markdown, and it is not executed by this conversion. Style blocks are not copied as a stylesheet. The formatter can indent those raw regions while keeping their text. This page’s job is the readable alternative syntax, which has no place for a style block. Whitespace that only existed to indent tags is not meaningful in markdown and will not be preserved as indent of the tags.

Round trip is not the offer

Turning the markdown back through the other page will not restore classes, handlers, or the original tag set. The markdown-to-HTML page also sanitizes the HTML it emits. Start from HTML here when you want a markdown draft. Edit that draft. Do not treat the pair of pages as a lossless archive format. A fragment that was already markdown should not be fed through this page, or angle brackets and hashes will be read as markup.

Privacy

Your input is processed in your browser and is not uploaded to UtilChain. File names, text, and results are not sent to analytics.