Frequently Asked Questions

Find answers to common questions about HTML to Markdown conversion, API usage, features, and best practices.

Getting Started

How do I convert HTML to Markdown?

Simply paste your HTML code or enter a URL in our converter, and it will automatically convert to high-quality Markdown. You can also use our API for programmatic conversion.

Is htmltomarkdown.io really free?

Yes! Our basic conversion service is completely free with no registration required. We also offer premium features like API access, batch processing, and advanced tools for professional users.

Do I need to create an account?

No account is required for basic HTML to Markdown conversion. You can start converting immediately. Premium features like API access and batch processing require registration.

What browsers are supported?

htmltomarkdown.io works on all modern browsers including Chrome, Firefox, Safari, and Edge. We recommend using the latest version for the best experience.

Features & Capabilities

What HTML elements are supported?

We support all standard HTML5 elements including headings (h1-h6), paragraphs, links, images, ordered and unordered lists, tables, code blocks, blockquotes, and text formatting (bold, italic, underline, strikethrough). Complex layouts are simplified for Markdown compatibility.

Can I convert entire websites?

Yes! Use our batch converter with sitemap import to convert multiple pages from entire websites. You can also use our API for automated website conversion workflows.

Does it work with JavaScript-rendered content?

Our URL converter fetches the initial HTML response. For JavaScript-heavy applications (SPAs), save the rendered HTML from your browser and paste it directly into the converter.

What's the maximum file size I can convert?

The web interface supports HTML files up to 5MB. For larger files, use our API or split content into smaller chunks. Enterprise customers can request higher limits.

What Markdown flavor do you use?

We use GitHub Flavored Markdown (GFM) by default, which includes tables, task lists, strikethrough, and code fences. You can also select other flavors like CommonMark, MDX, or custom variants.

API & Integration

How do I use the API?

Sign up for an API key in your dashboard, then make POST requests to our API endpoint. We provide SDKs for popular languages and detailed documentation.

curl -X POST https://api.htmltomarkdown.io/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html": "<h1>Hello World</h1>"}'

What are the API rate limits?

Free tier: 100 requests/day. Pro tier: 1,000 requests/day. Enterprise: unlimited. Rate limits reset at midnight UTC. Check API response headers for current usage.

Can I use the API for commercial projects?

Absolutely! Our API is designed for commercial use. We offer flexible pricing based on usage volume and specific business needs.

Is there a JavaScript/Node.js library?

Yes! We provide official NPM packages for JavaScript/TypeScript, Python, Ruby, Go, and other popular languages. Check our documentation for installation instructions.

How do I handle batch conversions with the API?

Use our batch endpoint with an array of HTML content or URLs. The API returns a job ID, and you can poll for completion or use webhooks for notifications.

Pricing & Plans

What's included in the free plan?

Free plan includes: 100 conversions/month, web interface access, basic Markdown output, email support, and all standard HTML element support.

What features are in the Pro plan ($29/month)?

Pro plan includes: Unlimited conversions, API access (1,000 requests/day), batch processing, advanced formatting options, priority support, custom Markdown flavors, and export to multiple formats.

Do you offer enterprise plans?

Yes! Enterprise plans include unlimited API calls, dedicated infrastructure, custom integrations, SLA guarantees, advanced security features, and dedicated support. Contact us for custom pricing.

Can I cancel my subscription anytime?

Yes, you can cancel your subscription at any time. Your access continues until the end of your current billing period, and you won't be charged again.

Do you offer discounts for non-profits or educational institutions?

Yes! We offer special pricing for qualified non-profits, educational institutions, and open-source projects. Contact us with your organization details.

Privacy & Security

Do you store my HTML content?

No, we do not permanently store your HTML content. Conversions happen in real-time, and temporary data is automatically deleted after processing. We only retain aggregated, anonymous usage statistics.

Is my data secure?

Yes, all data is transmitted over HTTPS encryption. We use industry-standard security practices and regular security audits to protect your information.

Can you see my conversion content?

No, our team cannot access individual conversion content. We only see aggregated, anonymized usage statistics for improving our service.

Where is your data processed?

Our primary servers are located in the United States with data replication across multiple regions. All processing complies with GDPR and other privacy regulations.

Do you sell or share user data?

Never. We do not sell, share, or distribute personal user data or conversion content. Your privacy is our top priority.

Technical Support

Why does my conversion look different from the original?

Markdown has fewer formatting options than HTML. Complex styling (colors, fonts, advanced layouts) cannot be represented in Markdown and are simplified to semantic equivalents. This is normal and expected behavior.

How do I handle nested lists correctly?

Use proper HTML structure with nested <ul> or <ol> elements. Our converter preserves nesting levels using indentation in Markdown (2 spaces per level).

My table conversion looks wrong. What should I do?

Complex tables with merged cells or nested elements may not convert perfectly. Try simplifying the table structure first, or keep it as HTML in your Markdown file (supported by most renderers).

Code blocks lose syntax highlighting. How to fix this?

Ensure your HTML code blocks have language attributes (e.g., <code class="language-javascript">). Our converter preserves these as language hints in Markdown: ```javascript```

Images aren't converting properly. What's wrong?

Check that image URLs are absolute and accessible. For local images, upload them to your Markdown platform and update the URLs after conversion.

Advanced Usage

Can I convert from Markdown back to HTML?

Currently, we specialize in HTML to Markdown conversion. For Markdown to HTML, we recommend tools like marked.js, markdown-it, or remark.

How do I convert large websites efficiently?

Use our batch converter with sitemap import for automated processing. Set appropriate delays between requests to respect rate limits. Consider using our API for custom workflows.

Can I customize the conversion output?

Pro users can access custom formatting rules, style preferences, and output templates. Contact enterprise for fully customized conversion pipelines.

Is there a browser extension available?

Browser extensions are in development! For now, use our web interface or API. Extensions will provide one-click conversion from any webpage.

Can I integrate this into my CMS or workflow?

Yes! Our API supports integrations with WordPress, Drupal, static site generators, and custom CMS solutions. We also provide webhook support for automated workflows.

Troubleshooting

The converter is showing an error. What should I do?

Check if your HTML is well-formed. Try validating with an HTML validator first. If the error persists, contact support with the error message and a sample of your HTML.

Conversion is very slow. How can I speed it up?

Large files take longer to process. Try breaking into smaller chunks, removing unnecessary HTML, or using our API for faster batch processing.

I found a bug in the conversion. How do I report it?

Report bugs through our support portal or GitHub issues. Include the original HTML, expected output, and actual output. Screenshots help us diagnose issues faster.

Can I suggest new features?

Yes! We welcome feature suggestions. Submit ideas through our feedback form or GitHub discussions. Popular requests are prioritized in our roadmap.

The service is down. What should I do?

Check our status page for real-time updates. Follow us on Twitter for notifications. Most outages are resolved within minutes. Enterprise users have dedicated support channels.

Still Have Questions?

Can't find the answer you're looking for? Our support team is here to help. Check out our comprehensive documentation or reach out directly.