# HTML to Markdown Converter

> Turn HTML into clean Markdown — content without the navigation, ads, and markup noise around it.

## Why copy-paste fails

- Boilerplate noise — Navigation, footers, and ads surround the content you actually want.
- Nested markup — Deeply nested tags and inline styles obscure the real document structure.
- Inconsistent headings — Heading levels are often misused in HTML; clean Markdown normalizes the hierarchy.

## Format notes

- Boilerplate removal — Navigation menus, footers, sidebars, and ad containers are dropped; the parser focuses on the document's main content region.
- Headings and tables — HTML heading tags (h1–h6) map to Markdown headings and <table> elements become Markdown pipe tables.
- File upload vs. live URL — This tool converts uploaded .html or .htm files. To convert a live web page by URL, use the URL to Markdown converter at /url-to-markdown.
- Inline scripts and styles — Inline <script> and <style> blocks are stripped from the output; only visible document content is kept.

## Example output

Source: article.html

```markdown
# How Retrieval Works

Retrieval-augmented generation pairs a model with a search index.

## Chunking

Split documents into passages.
```

## FAQ

### Do I upload an HTML file?

Yes. Upload an .html or .htm file to convert it. To convert a live web page by URL, use the URL to Markdown converter at /url-to-markdown.

### What is the maximum file size?

The free converter accepts HTML files up to 10 MB.

### Is navigation and boilerplate removed?

Parsing focuses on the document content rather than surrounding page chrome such as nav menus, footers, and ad blocks.

### How are headings handled?

HTML heading tags (h1–h6) map directly to Markdown heading levels, preserving the document hierarchy.

### Are tables preserved?

Yes. HTML tables are converted to Markdown pipe tables with their column structure intact.

### What about inline scripts and styles?

Inline <script> and <style> content is stripped. Only the visible document text and structure is output.

### Is sign-up required?

No. Preview is free; download and history use a free account.

### Is there a developer API?

Yes. Convert HTML files programmatically via the REST API. See /developers for documentation.