Documentation

Quick Start

HTML to Markdown is a free online tool that converts HTML content into clean Markdown format. No sign-up required, no data stored on our servers.

How to Use

1. Choose your processing mode: Local (privacy-first) or API (enhanced features)
2. Choose your input method: HTML Code or URL
3. Paste your HTML code or enter a URL
4. Click the "Convert" button (or press Ctrl + Enter)
5. Copy or export your Markdown result

Processing Modes

Features

HTML Code Conversion

Paste any HTML code directly into the editor. The converter supports all standard HTML elements including:

• Headings (h1-h6)
• Text formatting (bold, italic, underline, strikethrough)
• Links and images with proper markdown syntax
• Lists (ordered and unordered)
• Code blocks and inline code with syntax highlighting
• Blockquotes and nested quotes
• Tables with proper alignment
• Task lists (GitHub Flavored Markdown)

URL Conversion

Enter any public URL and we'll fetch the HTML content and convert it to Markdown. Perfect for:

• Saving web articles and blog posts
• Converting documentation pages
• Archiving online content
• Creating offline reading copies

Keyboard Shortcuts

Speed up your workflow with these keyboard shortcuts:

API Documentation

For developers, we provide a REST API for programmatic HTML to Markdown conversion. Integrate our service into your applications with just a few lines of code.

Public Endpoints

Free endpoints for testing and low-volume usage:

1POST /api/v1/public/convert
2Content-Type: application/json
3 
4{
5  "html": "<h1>Hello World</h1><p>This is a paragraph.</p>"
6}

1POST /api/v1/public/convert-url
2Content-Type: application/json
3 
4{
5  "url": "https://example.com/article"
6}

Authenticated API

For higher rate limits and batch processing capabilities, contact us for an API key. Authenticated endpoints include:

• Higher rate limits (up to 1000 requests per minute)
• Batch processing for multiple URLs
• Priority processing queue
• Custom conversion options

Rate Limits

Using API Mode in the Web Interface

The easiest way to use our API is through the web interface:

1. Navigate to the homepage converter
2. Click the mode toggle at the top to switch from "Local" to "API"
3. The interface will automatically use the API for conversions
4. If the API is unavailable, it automatically falls back to local processing

Best Practices

Clean Your HTML

For best conversion results, clean your HTML before conversion:

• Remove unnecessary inline styles and scripts
• Ensure proper HTML structure with semantic tags
• Avoid deeply nested tables or complex layouts
• Test with smaller sections first

Handle Large Documents

For large documents or batch processing:

• Consider breaking large content into smaller sections
• Use the API for automated batch processing
• Implement retry logic for network issues
• Cache conversion results when possible

Test Your Output

Always test your Markdown output:

• Preview in your target platform (GitHub, Notion, etc.)
• Check for proper table formatting
• Verify link and image references
• Test code block syntax highlighting

Conversion Options

Customize how HTML is converted to Markdown with these options:

Supported HTML Elements

Our converter supports a comprehensive set of HTML elements:

Limitations

Need Help?

Can't find what you're looking for? Check our resources: