Convert HTML to Markdown

Why convert HTML to Markdown?

Markdown is the format of documentation, README files, static site generators and note apps. Content that lives in a CMS or on a web page, however, is HTML. Rewriting it by hand is slow and error-prone, especially with lists, links and tables. A converter maps each HTML element to its Markdown equivalent: <h2> becomes ##, <strong> becomes **bold**, <a href> becomes [text](url), and so on.

This tool uses Turndown with the GitHub-Flavored Markdown plugin, so it also converts tables, strikethrough text and task lists (checkboxes). You choose the style of the output: headings as # (ATX) or underlined (Setext), bullet lists with - or *, and code blocks fenced with ``` or indented with four spaces. That way the Markdown matches the conventions of your project or of the platform you are moving to.

Markdown has no equivalent for everything HTML can do. Layout markup, classes, inline styles and scripts are dropped, because Markdown only describes content. What you get is the text with its structure: headings, paragraphs, emphasis, links, images, lists, quotes, code and tables.

For the cleanest result, paste only the HTML of the article or section you want, not the whole page with its navigation, sidebar and footer. The conversion runs in your browser and nothing is uploaded. You get one free try per tool: one file or one pasted text. After that you can still re-process the same text with different options, but new input needs ToolStudio Pro, which gives unlimited use of every tool, several files at once downloaded together in a ZIP, and no ads. You can cancel anytime.

How to convert HTML to Markdown

1. 1Paste the HTML or drop an .html file.
2. 2Choose the heading style: # (ATX) or underlined (Setext).
3. 3Choose the bullet marker (- or *) and fenced or indented code blocks.
4. 4Convert, then copy the Markdown or download it as an .md file.

What people use it for

• Migrating blog posts from WordPress or another CMS to Hugo, Jekyll or Astro.
• Moving help center articles into a docs site.
• Writing a GitHub README from an existing HTML page.
• Saving a web page section as notes in Obsidian or Notion.
• Converting HTML tables into Markdown tables.
• Feeding clean text to tools that expect Markdown.

ATX vs Setext headings

ATX headings use hashes: # Title, ## Section, up to ###### for level 6. Setext headings underline the text with === for level 1 and --- for level 2. Setext only exists for those two levels, so levels 3 to 6 are always written with hashes. ATX is the most common choice today and the one most tools expect.

How common elements are converted

• <h2>Intro</h2> becomes ## Intro.
• <em>text</em> becomes _text_ and <strong>text</strong> becomes **text**.
• <a href="https://example.com">link</a> becomes [link](https://example.com).
• <img src="a.png" alt="Logo"> becomes .
• <del>old</del> becomes ~~old~~ and <input type="checkbox" checked> in a list becomes - [x].
• <pre><code> becomes a fenced or indented code block.

Frequently Asked Questions