> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/microsoft/markitdown/llms.txt
> Use this file to discover all available pages before exploring further.
# HtmlConverter
> Convert HTML files to clean Markdown using BeautifulSoup and custom markdownify
## Overview
The `HtmlConverter` class converts HTML and XHTML documents to Markdown. It uses BeautifulSoup for parsing and a custom Markdownify implementation for conversion. This converter is also used as a base class for other converters (DOCX, PPTX, EPUB) that produce HTML as an intermediate format.
## Dependencies
Included in base install: `beautifulsoup4`, `markdownify`
## Accepted Formats
* `text/html`
* `application/xhtml*`
* `.html`
* `.htm`
## Class Definition
```python theme={null}
class HtmlConverter(DocumentConverter):
"""Converts HTML content to Markdown."""
```
## Methods
### accepts()
```python theme={null}
def accepts(
file_stream: BinaryIO,
stream_info: StreamInfo,
**kwargs: Any,
) -> bool
```
Returns `True` for HTML/XHTML files based on extension or MIME type.
### convert()
```python theme={null}
def convert(
file_stream: BinaryIO,
stream_info: StreamInfo,
**kwargs: Any,
) -> DocumentConverterResult
```
Converts HTML from a file stream to Markdown.
**Parameters:**
Binary stream of the HTML file
Metadata about the file (must include charset if not UTF-8)
**Returns:** `DocumentConverterResult` with Markdown and extracted title
### convert\_string()
```python theme={null}
def convert_string(
self,
html_content: str,
*,
url: Optional[str] = None,
**kwargs
) -> DocumentConverterResult
```
Convenience method to convert HTML string directly to Markdown.
**Parameters:**
HTML content as string
Optional URL for the HTML content (used in StreamInfo)
**Returns:** `DocumentConverterResult` with Markdown
## Features
### HTML Cleaning
Before conversion, the HTML is cleaned:
1. **Script Removal** - All `