---
title: New conversion options for Markdown Conversion
description: Control how images, HTML, and PDFs are processed when converting to Markdown
image: https://developers.cloudflare.com/changelog-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/changelog/llms.txt  
> Use this file to discover all available pages before exploring further. 

[Skip to content](#%5Ftop) 

# Changelog

New updates and improvements at Cloudflare.

[ Subscribe to RSS ](https://developers.cloudflare.com/changelog/rss/index.xml) [ View RSS feeds ](https://developers.cloudflare.com/fundamentals/new-features/available-rss-feeds/) 

![hero image](https://developers.cloudflare.com/_astro/hero.CVYJHPAd_26AMqX.svg) 

[ ← Back to all posts ](https://developers.cloudflare.com/changelog/) 

## New conversion options for Markdown Conversion

Mar 04, 2026 

[ Workers AI ](https://developers.cloudflare.com/workers-ai/) 

You can now customize how the [Markdown Conversion](https://developers.cloudflare.com/workers-ai/features/markdown-conversion/) service processes different file types by passing a `conversionOptions` object.

Available options:

* **Images**: Set the language for AI-generated image descriptions
* **HTML**: Use CSS selectors to extract specific content, or provide a hostname to resolve relative links
* **PDF**: Exclude metadata from the output

Use the [env.AI](https://developers.cloudflare.com/workers-ai/features/markdown-conversion/usage/binding/) binding:

* [  JavaScript ](#tab-panel-2657)
* [  TypeScript ](#tab-panel-2658)

JavaScript

```
await env.AI.toMarkdown(  { name: "page.html", blob: new Blob([html]) },  {    conversionOptions: {      html: { cssSelector: "article.content" },      image: { descriptionLanguage: "es" },    },  },);
```

TypeScript

```
await env.AI.toMarkdown(  { name: "page.html", blob: new Blob([html]) },  {    conversionOptions: {      html: { cssSelector: "article.content" },      image: { descriptionLanguage: "es" },    },  },);
```

Or call the REST API:

Terminal window

```
curl https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai/tomarkdown \  -H 'Authorization: Bearer {API_TOKEN}' \  -F 'files=@index.html' \  -F 'conversionOptions={"html": {"cssSelector": "article.content"}}'
```

For more details, refer to [Conversion Options](https://developers.cloudflare.com/workers-ai/features/markdown-conversion/conversion-options/).

```json
{"@context":"https://schema.org","@type":"BlogPosting","@id":"https://developers.cloudflare.com/changelog/post/2026-03-04-new-markdown-conversion-options/#page","headline":"New conversion options for Markdown Conversion · Changelog","description":"Control how images, HTML, and PDFs are processed when converting to Markdown","url":"https://developers.cloudflare.com/changelog/post/2026-03-04-new-markdown-conversion-options/","inLanguage":"en","image":"https://developers.cloudflare.com/changelog-preview.png","dateModified":"2026-03-04","datePublished":"2026-03-04","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
```