OpenAICloudflare Developer PlatformMar 4, 2026, 12:00 AM

Workers AI - New conversion options for Markdown Conversion

A condensed section focused on the key takeaways first.

Original Post

OpenAI Claude

Quick Digest

Summary

A condensed section focused on the key takeaways first.

openaienmodel: gpt-5-mini-2025-08-07

Workers AI - New conversion options for Markdown Conversion

workers-ai markdown conversion images html pdf api

Key Points

Per-file conversionOptions
Image description language support
HTML extraction via CSS selector

Summary

Workers AI's Markdown Conversion endpoint now accepts a conversionOptions object so you can customize how different file types are processed (image, html, pdf). This lets you set the language for AI-generated image descriptions, extract specific HTML content via CSS selectors or resolve relative links with a hostname, and exclude PDF metadata from the generated Markdown.

Key Points

Supported options:
- image: descriptionLanguage — choose language for generated image descriptions (e.g., "es").
- html: cssSelector — extract content using a CSS selector; hostname — resolve relative links.
- pdf: excludeMetadata — omit metadata from the output.
Use in Workers (JavaScript/TypeScript) by passing conversionOptions to env.AI.toMarkdown(...) for per-file processing.
REST API: send conversionOptions as JSON in form-data with -F 'conversionOptions=...'.

Examples (concise):

JavaScript/TypeScript usage: await env.AI.toMarkdown({ name: "page.html", blob: new Blob([html]) }, { conversionOptions: { html: { cssSelector: "article.content" }, image: { descriptionLanguage: "es" } } });
cURL REST call: 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"}}'

Refer to the Conversion Options docs for full parameter descriptions and additional examples.

Full Translation

Translations

A translation section that keeps the flow of the original article.

openaijamodel: gpt-5-mini-2025-08-07

Workers AI - Markdown Conversion の新しい変換オプション

Markdown Conversion サービスで、ファイルタイプごとの処理を conversionOptions オブジェクトを渡してカスタマイズできるようになりました。

利用可能なオプション

Images: AI生成の画像説明の言語を設定できます。
HTML: CSS セレクタで特定のコンテンツを抽出する、または相対リンクを解決するためのホスト名を指定できます。
PDF: 出力からメタデータを除外できます。

env.AI バインディングの使用例

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" },
    },
  },
);

REST API の呼び出し例

ターミナル:

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"}}'

詳しくは Conversion Options を参照してください。