📄 HTML to Markdown Converter

The HTML to Markdown Converter is a powerful tool that transforms any HTML webpage into clean, well-formatted Markdown. Simply provide the URL of the webpage you want to convert, and this actor will extract the content, process it intelligently, and deliver a polished Markdown file that preserves the structure and meaning of the original content.

🔄 Markdown Conversion Features

The HTML to Markdown Converter handles various HTML elements with specialized rules:

• Headings: Converts h1-h6 tags to equivalent Markdown headings
• Lists: Preserves ordered and unordered lists with proper formatting
• Tables: Maintains table structure with column alignment
• Code Blocks: Preserves code blocks with language syntax highlighting
• Images: Converts images with alt text and absolute URLs
• Links: Ensures all links are properly formatted with absolute URLs
• Emphasis: Preserves bold, italic, and other text formatting
• Blockquotes: Maintains blockquote formatting
• Media Elements: Creates Markdown-friendly references for videos, audio, and other media
• Interactive Elements: Provides descriptive text for forms, buttons, and other interactive components

🤔 Why convert HTML to Markdown?

Converting HTML to Markdown offers numerous benefits:

• 📝 Simplicity: Transform complex HTML into clean, readable text
• 🔄 Portability: Use the content across different platforms and tools
• 📊 Content Focus: Strip away unnecessary styling and scripts
• 🖋️ Easy Editing: Modify content in any text editor without HTML knowledge
• 📚 Documentation: Create documentation from existing web content
• 📱 Accessibility: Improve content readability for screen readers and assistive technologies

🚀 Main Features

HTML to Markdown Converter includes powerful features to ensure high-quality conversions:

• Smart Content Extraction: Automatically identifies and extracts the main content from webpages
• Relative URL Resolution: Converts all relative URLs to absolute URLs for proper linking
• Table Support: Preserves table structures with proper Markdown formatting
• Code Block Preservation: Maintains code blocks with language syntax highlighting
• Image Handling: Converts images with proper alt text and source URLs
• Video & Media Embedding: Creates Markdown-friendly references for videos and embedded content
• Interactive Element Conversion: Transforms buttons, forms, and other interactive elements
• Social Media Embed Handling: Properly references social media posts from platforms like Twitter/X, Instagram, etc.
• Custom Styling Rules: Applies consistent formatting for headings, lists, emphasis, and more

🛠️ How to use the HTML to Markdown Converter

Using the HTML to Markdown Converter is straightforward:

1. 🔑 Create a free Apify account (if you don't have one)
2. 🔍 Open the HTML to Markdown Converter actor
3. ✏️ Enter the URL(s) of the webpage(s) you want to convert
4. 🚀 Click "Save & Start" and wait for the conversion to complete
5. 💾 Download your Markdown files or access them via the provided links

📈 How many pages can you convert?

The converter can process multiple pages in a single run. The number of pages you can convert depends on your Apify subscription plan and the complexity of the webpages. For large-scale conversion projects, consider using a higher-tier plan.

⚖️ Is it legal to convert webpages to Markdown?

The converter only processes publicly available content and transforms it into a different format. However, be mindful of copyright restrictions when using the converted content, especially for commercial purposes. Always respect the original content's terms of use and attribution requirements.

📝 Input parameters

The actor accepts a JSON array of objects, each containing a url property.

Example input:

1{
2    "startUrls": [
3        {
4            "url": "https://example.com/page-to-convert"
5        },
6        {
7            "url": "https://another-example.com/another-page"
8        }
9    ]
10}

Output Example

The actor provides detailed information about each processed URL:

1{
2"url": "https://example.com/page-to-convert",
3"markdown": "https://api.apify.com/v2/key-value-stores/markdown-store/records/example.com.md",
4"title": "Example Page Title",
5"fileName": "example.com.md",
6"htmlLength": 45678,
7"markdownLength": 12345,
8"error": null,
9"success": true,
10"processedAt": "2023-09-15T14:25:30.000Z"
11}```

🚀 Unlock Content Flexibility

HTML to Markdown Converter is an essential tool for content creators, developers, and anyone who needs to repurpose web content. Whether you're creating documentation, preparing content for a CMS, or archiving web pages in a more readable format, this converter offers a comprehensive and efficient solution. If you have any feedback or run into issues, please don't hesitate to reach out through the Actor's Issues tab in the Apify Console. Happy converting! 🎉