HTML to Markdown — Clean GFM with Tables and Code

HTML

Markdown

Supported HTML Elements

<h1-h6><p><strong/b><em/i><a><img><ul/ol/li><blockquote><code><pre><hr><table><del/s>

This converter handles most common HTML elements. Complex or nested structures may require manual adjustments.

How to Convert HTML to Markdown

Paste or type your HTML

Copy your HTML code from any source, such as a webpage, email template, or CMS export, and paste it into the HTML input panel on the left side of the converter.
Review the live Markdown output

As soon as you paste or type HTML, the converter instantly generates clean Markdown syntax in the output panel. Check that headings, links, images, and lists are correctly translated.
Adjust and refine if needed

For complex HTML with deeply nested elements or custom styling, review the output for any sections that may need manual tweaking. The converter handles most standard elements automatically.
Copy the Markdown result

Click the Copy button to copy the converted Markdown to your clipboard. You can then paste it directly into GitHub, Notion, Obsidian, a static site generator, or any Markdown-compatible editor.

Common Use Cases

Content Migration

Migrate blog posts, documentation, or knowledge base articles from HTML-based CMS platforms (WordPress, Drupal, Ghost) to Markdown-based systems like Jekyll, Hugo, Astro, or Obsidian.

Documentation Workflows

Convert HTML API docs or internal wiki pages into Markdown files for version-controlled repositories on GitHub or GitLab, enabling collaborative editing and pull request reviews.

Email to Notes Conversion

Turn formatted HTML emails or newsletters into clean Markdown notes for personal knowledge management tools like Obsidian, Logseq, or Notion.

Static Site Development

Extract and convert HTML content from legacy websites into Markdown source files for modern static site generators such as Astro, Next.js, Eleventy, or Gatsby.

Why Use HTML to Markdown Converter?

Converting HTML to Markdown is essential for content migration, documentation workflows, and creating portable content. Markdown is simpler to read and write, works with version control, and is supported by most modern platforms including GitHub, Notion, and static site generators.

The HTML to Markdown Converter transforms HTML code into clean, readable Markdown syntax in your browser. Whether you are migrating content from a CMS, converting documentation for a Git repository, or extracting formatted text from a webpage, this tool handles headings, paragraphs, bold and italic text, links, images, ordered and unordered lists, blockquotes, code blocks, tables, and horizontal rules. On this page, the conversion is client-side, so your HTML is not uploaded to any server. The REST API and the MCP tool are a separate path: a call sends the HTML you include to FindUtils, which converts it without storing it.

Markdown has become the standard writing format for developers and technical writers. Platforms like GitHub, GitLab, Notion, and Obsidian all support Markdown natively. By converting your HTML content to Markdown, you gain version control compatibility, easier collaboration through pull requests, and a lightweight format that renders consistently across tools. For a whole saved web page, Site to Markdown keeps only the main content and drops the navigation, footer and scripts. For previewing your converted output, use the Markdown Previewer to render it in real time.

This converter outputs GitHub Flavored Markdown (GFM), which supports tables, strikethrough, and fenced code blocks beyond the basic CommonMark spec. If your HTML includes data tables, the converter produces properly formatted Markdown tables that you can further refine with the Markdown Table Generator. For cleaning up the HTML itself before converting, run it through the HTML Formatter first to ensure well-structured input and the best possible output.

How it compares

Many online tools that convert HTML to Markdown process the input on a server, which means your HTML is uploaded to a third party. On this page, the FindUtils HTML to Markdown Converter runs in your browser and does not upload the HTML, which suits sensitive or proprietary content. The REST API and the MCP tool are a separate path: a call sends the HTML you include to FindUtils, which converts it without storing it. Unlike paid services or CLI tools like Pandoc that require installation, this page works in any modern browser with no setup, no signup, and no usage limits.

Compared to adding a library such as Turndown to a project, this page converts through a simple paste-and-copy interface. It supports the GFM output format used by GitHub and most documentation platforms. For a whole saved page rather than a snippet, Site to Markdown keeps the main content and drops navigation, footers and scripts; it converts HTML you paste or upload and does not fetch URLs.

Tips for Better Conversions

Clean up unnecessary inline styles and class attributes from your HTML before converting for the best Markdown output.
Use the Load Sample button to see how different HTML elements map to Markdown syntax before pasting your own code.
For HTML tables, make sure your table uses proper thead and tbody elements so column headers are correctly detected.
If your HTML contains code blocks, wrap them in pre and code tags so the converter outputs fenced Markdown code blocks with correct formatting.
After converting, preview your Markdown in the Markdown Previewer tool to verify that the output renders exactly as expected.

Frequently Asked Questions

What HTML elements are supported?

The converter supports headings (h1-h6), paragraphs, bold/italic text, links, images, ordered and unordered lists, blockquotes, code blocks, horizontal rules, tables, and strikethrough text.

Will the conversion preserve my formatting?

Basic formatting like bold, italic, and headings is preserved. However, complex CSS styling and layout-specific HTML attributes will not be converted as Markdown doesn't support them.

Can I convert Markdown back to HTML?

This tool is one-way (HTML to Markdown). For the reverse conversion, use Markdown to HTML, which converts a Markdown document back into HTML you can copy or download.

How does it handle nested elements?

Simple nesting like bold text inside a link works well. Deeply nested structures may need manual cleanup for optimal Markdown output.

Is my HTML processed securely?

On this page, yes. The conversion happens in your browser, and your HTML code is not sent to any server. The REST API and the MCP tool are a separate path: a call sends the HTML you include to FindUtils over HTTPS, where it is converted and the result returned. FindUtils does not store that input, and logs the request without its content.

Does it support HTML tables?

Yes, HTML tables are converted to GitHub Flavored Markdown (GFM) table syntax with pipes and dashes. Column alignment and headers are preserved automatically.

Can I convert an entire webpage to Markdown?

Yes, but this page converts the HTML you give it as it is, so a whole page comes out with its menus and footer. For a whole saved page, Site to Markdown keeps only the main content and drops navigation, footers and scripts. Neither page fetches a URL: paste or upload the HTML.

What Markdown flavor does the output use?

The output follows CommonMark and GitHub Flavored Markdown (GFM) standards. This ensures compatibility with GitHub, GitLab, Notion, Obsidian, and most static site generators.

Is there a file size limit?

On this page, the conversion runs in your browser, so there is no server-side limit. However, extremely large HTML files (over 5 MB) may slow down your browser during conversion.

Do I need to sign up or create an account?

No. The HTML to Markdown converter is available with no signup, no account, and no usage limits. Just paste your HTML and get clean Markdown instantly.

Can I get HTML from a Word document, or a Word document from HTML?

Yes, both directions have their own page on FindUtils. DOCX to HTML reads a .docx and writes clean semantic HTML for a CMS or a blog editor; HTML to DOCX reads pasted or dropped HTML and builds an editable .docx with Word Heading styles, lists, tables and hyperlinks. On the page, both run in your browser and upload nothing.

Run it from code

$ curl -X POST \
  api.findutils.com/api/tools/html-to-markdown/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"html":"<h1>Hi</h1>"}'

$ claude mcp add findutils \
  --transport http https://mcp.findutils.com/ \
  --header "Authorization: Bearer YOUR_API_KEY"
# then call findutils:html_to_markdown

Running a tool needs an API key. Keys are not for sale yet: ask for early access. About API keys

The REST API and the MCP tool are a separate path from this page: a call sends the input you include to FindUtils over HTTPS, where it is processed and the result returned. FindUtils does not store that input, and logs the request without its content.

API reference Add to Claude

HTML to Markdown Converter